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A Note To The Header 


Congratulations on purchasing our MagiCard 6502 computer adapter 
card for your video game I First some words of caution: Never insert 
or remove the MagiCard or any controller connections to your game 
while It is turned on. Always handle the MagiCard by the edges and 
touch the game console switches with your free hand Just before 
inserting It. Avoid touching the TV screen with your hands or any of 
the game cables to further minimize the chance of damage due to static 
electricity. Finally, be sure you know which side of the MagiCard is 
"up" (see Chapter 2), and always insert it right side up. Most of 
these precautions are helpful with conventional cartridges as well, 
and if you make a habit of them, your game should function for many 
years. 

Depending on your experience with computers, and the 6502 in 
particular, you may be able to skip or skim the earlier chapters of 
this manual. Computer stores, bookstores and libraries often have a 
few of the many books written about the 6502. Don't try to road them 
all. Programming The 6502 , third edition, by Rodnay Zaks is one of 
several good ones. Some aspects of the game system are either too 
detailed to describe properly in a manual of limited size, or so 
obscure that we aren't sure what to say. These unclear areas are 
never vital to a basio understanding of the game and are generally 
deduclble from clues we give and from tests using the MagiCard itself. 
Happy exploringI 

In one respect, programming the MagiCard - Video Computer 
combination may be a now (and educational) experience even for some 
experienced programmers. It is a "real-time" system, with the 6502 
program handling all aspects of the display, sound and controller 
response on an instant by Instant basis. The display, for example, 



may be created line by line as the eleotron beam sweeps across the TV 
screen, requiring the program to reweave this evanescent tapestry 
every 1/60 second. Don't worry, the MagiCard makes it very easy to 
create certain displays, so you can start programming quickly. And it 
is possible, with effort, to program displays and games rivaling those 
available in cartridges. Welcome to the real (time) world. 


Computer Magic 1981 



Introduction 


Inside your Atari Video Computer System Is a powerful 6502 
microprocessor, a "computer on a chip." With this manual and your 
MaglCard, you will learn to program this tiny computer and explore the 
full capabilities of your Atari game. 

Chapter 1 will introduce you to some fundamental concepts about 
computers, including the ideas of a program, memory, and the 
hexadecimal number system—the language you will use to speak to your 
computer. If you are already familiar with these concepts, you may 
start with Chapter 2. 

Chapter 2 will show you how to get started with your MaglCard. 
By working through a few simple examples, you will learn how to write 
programs for your computer, how to enter programs and data into 
memory, and how to run your programs. You will learn to produce 
displays on your television screen and sounds through your television 
speaker. 

The last five chapters in the manual provide a variety of 
detailed information about the MaglCard and the Atari Video Computer 
System. Chapter 3 gives a detailed description of the 6502 
microprocessor. Chapter 4 covers the use made by the MaglCard of each 
key on your keyboard controllers. The memory map for the MaglCard is 
the subject of Chapter 5. Chapter 6 desorlbes the detailed workings 
of the Atari game features. Finally, Chapter 7 describes the MaglCard 
monitor subroutines that are of potential use to you in your programs. 



CHAPTER 1 


Computer Fundamentals 

All computers, from the smallest single-chip microprocessor to large 
machines that fill up a room, have certain features in common. 
Computers, although fast, accurate, and powerful, are really rather 
dumb. The only thing they can do is to execute a series of extremely 
simple instructions. Examples of such instructions are to add two 
numbers together, to move a number from one place to another, and to 
check if one number is larger than another. 

Also, all computers have three basic parts. These are 

1. The central processor unit (or CPU) . This is the brain of 
the computer, the place where it Interprets and executes the 
instructions. In your computer, the CPU is the 6502 
microprocessor Inside of your Video Computer System. 

2. The memory . This is the place where the computer stores 
information. Thi3 Information can be either a program, which 
is a list of Instructions for the computer to perform, or 
data, whioh is a list of numbers for the program to operate 
on. In your computer, there is a small amount of memory 
Inside of your Video Computer System and substantial 
additional memory on your MaglCard. 

3. Input-output devices . These are the computer*3 eyes, ears, 
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and mouth, the way It receives information (both programs and 
data) from the outside world, and the way it transmits its 
answers to you. In your computer, your keyboard controllers 
are the Input devloe, and your television screen and 
television speaker the output devices. If you build the 
audio cassette interface, a cassette recorder can bo used as 
both an output and input device for programs and data. 

Any problem you wish to solve on a computer, whether it be 
balancing your checkbook, playing a game, or forecasting the weather 
involves the same series of steps: 

1. You must write a program, a list of instructions telling the 
computer what to do. 

2. You oust enter the program into the computer memory by using 
an input device. 

3. You must enter into the computer memory the data that the 
program will operate on. (For example, consider balancing a 
checkbook. The program would be a list of instructions 
telling the computer to add deposits and subtract checks from 
your balance. The data would be a list of that month's 
opening balance, deposits, and checks.) 

You run the program. The computer executes your program, 
doing each instruction in order, and then displays the 
answers on its output devloe (provided you have included an 
instruction in your program telling it to do so). 
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Your MaglCard will enable you to follow these steps to perform a 
wide variety of tasks on your Video Computer System. Before going on 
to speoific details of the use of your MaglCard, we must first discuss 
a few more topics about computers in general. In particular, you will 
need to understand the hexadecimal number system, which is the 
language you will use to talk to your computer. You will need to 
understand a little more about the structure of a computer so that you 
will know what kinds of Instructions you can give it. 

First consider the hexadecimal (or hex) number system. In this 
manual numbers are in hex unless written out or expressly stated to be 
in decimal. Hexadecimal Is a number system based on 16, rather than 
our usual decimal number system based on 10. In our normal system, 
for example, the number 23 represents 2 tens plus 3 ones, or the 
quantity twenty-three. In hex, on the other hand, the digits 23 
represent 2 sixteens and 3 ones, or the quantity thirty-five (soe 
Figure 1). 


Decimal 


Hexadecimal 


tens ones 
place place 


sixteens ones 
place place 



quantity s 2x10 ♦ 3x1 quantity s 2x16 ♦ 3x1 


= twenty-three 


r thirty-five 


Figure 1 


Furthermore, a new way is needed to represent the quantities ten 
through fifteen with a single digit, and we choose to use the letters 
A, B, C, D, E, and F for this purpose. Thus, to count from one to 
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twenty in decimal and hex would look like: 

decimal: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 
hex: 0123456789 A B C D E F 10 11 12 13 14 

Hex is the language that your computer uses. You will need to be able 
to recognise that AB is a number, and that the number that cornea after 
AB ia AC. To find the decimal value of AB you can either look It up 
in the chart in Appendix A, or calculate it yourself as follows: 

AB s "A" sixteens ♦ "B" ones 
s 10 sixteens ♦ 11 ones 
3 160 ♦ 11 

s 171 

Now let's look In more detail at what Is Inside a computer. 
First, consider the memory. You should think of the memory as an 
ordered series of locations like the houses on a street. In each 
location you can 3tore either instructions for the computer or data. 
Moreover, again like the houses on a street, each location in memory 
has an address. The address of the first location in memory is zero, 
and each subsequent location has an address one higher than the 
previous location. These addresses are hex numbers. For example, as 
in Figure 2, the first several locations in memory have addresses 00, 
01, 02, 03, etc., while later on in memory there is a group of 

locations with addresses A9, AA, AD, AC, etc. 
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Figure 2 


The address of a location of memory is very important because it is 
the way that the computer finds the correct instruction to execute or 
the right piece of data to use (Just like you use the address of a 
house to find the right house on a strange street). 

Now you can understand the order in which the computer executes 
its Instructions. It goes through the. memory and executes the 
instructions in order (like a salesman Knocking on the door of one 
house after another on the street). For example, you might tell the 
computer to start by executing the instruction in memory location A7. 
It will then continue with the Instruction at A8, then A9» AA, etc. 
The computer will proceed along in this manner until it finds an 
Instruction telling It to stop, or a special kind of instruction 
(called a "Jump") telling it to Jump off and start executing 
Instructions in sequence starting at a new location. For example, 
consider the part of a program shown in Figure 3» 
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Figure 3 

If you start the computer at address A7, it will execute in order the 
instructions at A7, A6, A? (which causes it to Jump), BC, BD, and BE, 
where it will stop. In fact, one instruction can occupy several 
locations in sequence. That does not complicate the simple exeoutlon 
of locations in order. 

Finally, wo discuss Just what the various Instructions tell the 
computer to do. (You have already learned about two instructions in 
the above example: STOP and JUMP). To do this you must know a little 
bit about the central processor unit (CPU) of your computer. Inside 
the CPU are some special locations called ’•registers". Data is moved 
from locations in memory into these registers, where the data can be 
manipulated. A "LOAD" Instruction moves data from memory to a 
register. A "STORE" instruction moves data from a register to memory. 
Other instructions operate on the data in a register; for example, 
"ADD" instructions add a number to the register and "SUB" instructions 
subtract a number from the register. You can understand this more 
clearly by following the state of memory and of a register after the 
execution of each Instruction of a simple program. The program (see 
Figure *4) is designed to add the number stored in memory location C2 
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to a running total stored in loaction Cl. 


Memory Register 



Figure 4 

The initial contents of the register is zero and the first instruction 
to be executed by the computer is contained in memory location A5 
(LOAD Cl). After executing the first instruction (Figure 5a), the 
contents of location Cl, namely the number 10, has been moved into the 
register. 



(a) (b) (c) 

Figure 5 


The computer then executes the instruction at location A6 (ADD C2), 
which causes the contents of location C2, the number 5, to be added 
into the register. Now the state of the computer is as shown in 
Figure 5b. Finally, the computer executes the instruction at location 
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A7 (STORE Cl), which copies the contents of the register back into 
location Cl. The new state of the computer Is as shown In Figure 5c, 
with the sum stored back into location Cl. The computer will continue 
executing instructions with whatever instruction 1s in location A8. 

The general features Just illustrated are common to all 
computers. Each model of cooputer will have at most a slightly 
different internal arrangement, with different kinds of registers and 
a different set of instructions. After you have understood the 
material in this chapter, you are ready to go on to learn about the 
specific instructions available in your computer, the 6502 
microprocessor, and to learn how to use your HagiCard. 



CHAPTER 2 


USING YOUR MAGICARD 

2.1 PLUGGING IN AND TURNING ON 

The first step is to assemble your MagiCard system, which Is 

little more difficult than plugging any game cartridge into the game 

console. With the On/Off switch off, insert your MagiCard into the 

large slot centered in the cartridge part of the game console. You 

will need to stick the small sliver of fiberglass board provided Into 

one of the small slots on either side of the larger slot to open the 

door behind the large slot. 3e sure the component side of the 

MagiCard — the side with the plastic electronic parts —is facing up . 

It is a good Idea to always handle your MagiCard by the side edges. 

Make sure it is firmly seated in the slot. Next, plug in the two 

I 

keyboard controllers. (If you do not already own a set, keyboard 
controllers are available at moat stores selling Atari cartridges.) 
Slide the two controllers together, making sure the controller on the 
left-hand side is plugged into the left-hand part of the game console. 
For your convenience, two cardboard templates giving the functions of 
the keys have been provided. If you wish, you can place these over 
the keys of the controllers. 

Now, turn your game on. The letters cMx-2 should appear In the 
middle of your TV screen, and there should be a small square blinking 
about once per second near the top. cMx-2 identifies the MagiCard (if 
you buy other products from us they will Identify themselves 
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differently). The blinking square Indicates the MagiCard is ready to 
accept your commands. (If you do not see this display, make sure your 
game console ha3 its power cord connected and plugged in, that it is 
attached to your TV set, that the switch near the TV is in the game 
position, that your TV is tuned to the proper channel, and that the 
MagiCard and keyboard controllers are firmly plugged in.) 

Now you are ready to start learning the function of the various 
keys on the keyboard controllers. First, consider the 16 keys shown 
in figure 6, 



Figure 6 

used for the 16 hex digits. Try pressing some of these keys one at a 
tine. (Don't press any other keys yet.) As you press them, you will 
hear a beep and 3ee the hex digits appear on the upper right of your 
TV screen (ignore the number FOFO which appears on the left—it has no 
meaning yet). Practice entering various hex numbers. This is the way 
you will enter instructions and data into your computer. If you sake 
a mistake, just start over again pressing the correct numbers. They 
will replace the Incorrect ones, as you can observe on your TV. 
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2.2 STORING NUMBERS IN MEMORY 

Now that you know how to get hex numbers up on the TV screen, you 
are ready to learn how to store numbers in the computer's memory. You 
will first have to tell the computer the address of the memory 
location you wish to store a number into, and then tell it the number 
you wish to store. To do this you use the two new keys shown in 
Figure 7, 


Figure 7 

the "Store Address” (ST. AD.) and '’Store" keys. (The X*s in figure 7 
represent keys you have already learned about.) 


The sequence of steps to load hex numbers (which can represent 
either instructions or data) into the computer's memory is as follows: 

1. Type in the 4-digit hex number of the address you want to 
store into. It appears at the upper right of the TV screen. 
(For example, type in F030.) 

2. Press the "Store Address" key. The only visible effect this 

will have will be to change the number at the upper left of 

the TV screen from FOFO to 0000. More Importantly, this 
tells the computer that the number you Just typed in, in this 
case F030, Is the address of a location in memory into which 
you intend to store a number. 

3. Type in the 2-digit hex number you wish to store. For 

example, type 55. The upper right of the TV should now read 
3055 (The 30 is left over from the FQ30 you typed in Step 1. 
Only the 55 is Important, because a single memory location is 
only large enough to contain two hex digits. Only the last 
two digits count in these circumstances, and so the 55 will 
be stored and the 30 Ignored). 

4. Press the "Store" key. This is what actually causes the 

number 55 to be stored into memory location F030. This 
should cause two effects on your TV screen: first, F030 

should appear at the upper left as a reminder that you have 
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Juat stored into that location; and second, a pattern of 4 
dots should appear Just under F030. The four dots appear 
because the data In netaory location F030 is used to generate 
the picture at one position on the TV screen. Originally 
this location contained 00 and so that area of the TV screen 
was blank; but when you stored 55 into that location you 
caused a pattern to appear on the TV. (In the last section 
of this chapter a aore detailed discussion Is given on how to 
draw whatever patterns you want on the TV screen.) 


For more practice storing Into memory repeat steps (1)-(4) using 
different memory locations (try F05A and F084 Instead of F030) and 
different data (try 33 and FF instead of 55). You should see 
different patterns appear at different places on your TV. In each 
case, however, the address that you've stored Into should appear at 
the upper left of the TV. 

Certain memory locations in your computer have special functions. 
For example, memory location 0008 sets the color of objects appearing 
on your TV. As an exercise, try storing 85 into location 0008. (This 
involves going through Steps (l}-(4), typing in 0008 at Step l and 85 
at Step 3«) When you press the "Store" key, the numbers on your TV 
will change fron pink to bluet (A list of all these special locations 
and their functions is given in later chapters of this manual.) 

Now you are ready for some exercises: 

Exercise 1 : Turn the numbers on the TV back to pink. (The pink color 
corresponds to the number 55.) 

Answer : Store 55 into location 0008. 


You might like to experiment by storing different numbers into 
location 0008 and seeing the different colors your computer can 
produce. Be careful, however. If you store 00 into location 0008 the 
numbers will seem to disappear, because they will be drawn in the same 
color as the background! To make them reappear you will have to store 
a non-zero number into 0008. By the way, the color of the background 
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is determined by the number stored Into memory location 0009; 
therefore, by storing into both 0008 and 0009 you can produce 
arbitrary combinations of colors. 

Exercise 2 : Erase the pattern of dots you created when you first 
stored numbers into memory. 

Answer : Store 00 into F030, F05A, F08*i, and any other locations you 
stored a non-zero value into to clear those areas of the TV 
screen; or 

Alternate answer ; Press the "Game Reset" switch on your game console. 
This will clear off the screen, restore the original pink color, 
and give you a fresh start. 

Finally, there is one more thing you need to know about storing 

numbers into memory which is especially important when you want to 

store into several memory locations in a row (as you will certainly do 

whenever you enter programs into the computer). Each time you press 

the "Store" key, the computer adds one to the address it Just stored 

into and will automatically do the next store there (unless you put In 

a different address by pressing the "Store Address" key). Thus, to 

store into a series of consecutive memory locations you need only do 

I 

Steps (1) and (2) above once, for the first memory location in the 
series. You then simply repeat Steps (3) and (H), typing in the 
numbers and pressing the "Store" key, as many times as necessary. The 
numbers will be entered into consecutive memory locations. Moreover, 
if you want to enter the same number Into a series of locations you 
only need to do Step (3) once. The computer will remember the number 
you want to store, and each time you press the "Store" key it will 
store this same number In the next memory location. 
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As an illustration of thia try the following exercise: 

1. Type in F030 

2. Press "Store Address" 

3. Type in 55 

**. Press "Store". F030 appears at the upper left, and one set 
of dots appears. 55 has been stored into location F030. 

5. Press "Store" again. F031 appears at the upper left, and an 
identical set of dots appears right under the first set. 55 
has been stored into location F031. 

6. Type in AA 

7. Press "Store". AA is stored into location F032. F032 

appears at the upper left and a different pattern of dots 
appears under the first two sets. 

8. Continue pressing "Store". AA is successively stored into 
F033, F03^, F035, etc. When you have mastered this exercise, 
you know all there is to know about storing numbers into 
memory and are ready to loarn how to fetch numbers back from 
memory. 
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2.3 FETCHING NUMBERS FROM MEMORY 

Fetching numbers from memory works the same way as storing 
numbers to memory, using the two new keys shown in Figure 8, 


XXX 

XXX 

XXX 


FETCH XX 


XXX 

XXX 

XXX 


FET.AD. X X 


Figure 8 

the "Fetch Address" and "Fetch" keys. The sequence of steps to fetch 
a hex number from the computer's memory and to display it cn the TV 
screen is as follows: 

1. Type in the 4-dlglt hex number of the address in memory you 
want to fetch from. As usual, It appears at the upper right 
of the TV screen. (For example, type In F800.) 

2. Press the "Fetch Address" key. 

3* Press the "Fetch" Key. This will cause the address of the 
memory location (in the example F800) to appear at the left 
of the TV screen, and will cause the two hex digits of 
information (either data or program) contained in that memory 
location to be fetched and displayed on the right side of the 
TV screen as the last two digits, (tn the example the right 
side of the TV reads 0009; 09 is the contents of location 

F800. As when you were storing numbers to memory, the first 
two digits of the displayed number are irrelevant.) 


You can examine a series of memory locations Just by repeating 
Step (3). Each time you press the "Fetch" key, you will see the 
address on the left of the TV screen Increase by 1, and two new digits 
will appear on the right of the TV indicating the contents of that 
memory location. 

Exercise 3 : Store 00, 01, 02, ..., OF into the successive memory 
locations F300, F301i F302, ...F30F, and then fetch the numbers 


back out of those memory locations to insure that you stored them 
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correctly. 


1. Type In F300. 

2. Press "Store Address". 

3. Type In 00. 

il. Press "Store". You should now see F300 0000 at the top of 
the TV. 

5. Type In 01 and press "Store". You should see F301 0001. 

6. Continue typing in numbers and pressing "Store" until you got 
to OF. You should 3ee F30F 0E0F on the TV. 

7. Type in F300 and press "Fetch Address". 

8. Press "Fetch". You should see F300 0000, verifying that the 
contents of memory location F300 are 00. 

9. Press "Fetch" again. You should see F301 0001, showing that 
the contents of location F301 are 01. 

10. Press "Fetch" again. You should see F302 0102, showing that 
the contents of location F302 are 02. 

11. Continue pressing "Fetch", stepping through the memory 
addresses and verifying their contents until you get to F30F. 
The TV should display F30F OEOF. 


When you have mastered this exercise you will Know how to store 
hex numbers (which can be either instructions or data) into the 
computer's memory, and how lo fetch the numbers from memory to verify 
that they were 3tored correctly. The last thing you need to know 
before going on to write programs for the computer is the arrangement 
of the different areas of memory in your computer. 


There are four distinct areas of memory: 

1) Addresses FSOO-FFFF: ROM (read-only memory) 

This area of memory can only be read (fetched from) and not 
stored to; hence, the name read-only memory. Its contents are 
permanent—you cannot change them, and more importantly, its 
contents remain the same even when you turn the power on and off. 
This type of memory is used In computer systems for storage of 
programs and data that are Intended to be permanent and never 
change. 
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In your MaglCard system this area of memory contains a 
program called the monitor. This memory resides In the MaglCard 
on the large chip closest to the connector. The monitor program 
was permanently stored In this chip at our factory, and is 
instantly available to you whenever you turn on your MaglCard 
system. 

This monitor program is the program that starts to run 
automatically whenever you turn your system on. You have been 
using this program all along as you have been learning to fetch 
and store. This monitor program reads the keyboard controllers 
and executes the commands you give It, as well as constantly 
updating the display on the TV screen. You will learn about 
other useful monitor functions shortly; in particular, you will 
learn how to tell the monitor program to transfer control from 
Itself to a new program that you have written and stored In the 
computer's memory. 

2) Addresses F000-F3FF: RAM (random-acce33 memory) 

This area of memory can be both fetched from and stored to. 
It la the area you have been using above in the 3tore and fetch 
exercises. It la used for temporary storage of programs and 
data. The contents of RAM are lost when you turn the power off. 

This RAM resides on your MaglCard on the two medium-sized 
chips next to the ROM chip. They contain a total of 102^ memory 
locations, each of which Is large enough to contain two 
hexadecimal digits. This amount of memory Is often referred to 
as IK bytes of RAM: IK meaning 102*J locations; byte meaning a 
location of memory big enough to contain two hex digits; and RAM 
meaning memory that can be both stored to and fetched from. 

The various locations In the RAM memory can be used for 
whatever purposes you want, depending on what program is running 
at the time. For example, the monitor program uses locations 
F000 through F0D1 to save the data describing the TV display, 
which is why the display changed when you stored numbers Into 
these locations. Eventually, you will want to store data into 
locations F000-F3FF from a program. Unlike other locations, this 
requires a special method described later In this chapter and in 
Section 7.2. 

3) Addresses OOeO-OOFF: RAM 


These addresses are for additional RAM located inside your 
Video Game Console. They are used In the same manner as tho RAM 
described above, but without restrictions on use by a program. 

*0 Addresses 0Q00-Q03F: Video Display Generator 

These addresses represent special locations in the video 
display generator chip Inside your game console. Storing to 
these locations will change the display on your TV or produce 
sounds. You have already used two of these locations when you 
stored into locations 0008 and 0009 to change the color of the 
display. You will learn about a few of these locations as you 
examine some simple programs presented later in this chapter. 
More details are given in Chapter 6. 
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2.4 CREATING AND RUNNING PROGRAMS 

You are now ready to learn to create programs for your computer, 
store them in memory, and run them. In this section you will go 
through the steps necessary to run programs, using the techniques to 
store and fetch you've already learned as well as the new keys "Shift" 
and "Run" shown in Figure 9. 



Figure 9 

We will also describe the "Hex Dump" and "Ins Dump" (Instruction Dump) 
keys, which make it easier to verify that a program has been stored 
correctly in memory. 

Any program, from the simplest to the most complex, must go 
through the same stages. First, the problem must be clearly stated. 
Next, the problem should be broken down into a series of small pieces. 
Finally, each of these pieces is translated into a series of computer 
instructions in computer machine language which can then be stored in 
the computer's memory. The program is then ready to run. 

As a first simple example, we present a program to show all the 
different colors the video display generator can make on the TV. We 
go through the stages In writing this program in some detail to 
illustrate how a program is written. Later, examples will be more 
abbreviated, so you should spend some time on this first example to 
Insure you thoroughly understand it. 
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First comes the statement of the problem. In our example, we 
want to display all colors on the TV. However, this is not really a 
precise enough statement of the problem. In general, It will be more 
useful to state the problem in a way more related to the computer. 
For this example, we need to recall Just how to display a color on the 
TV: it is done by storing a number into memory location 0009. Thus, 

stated more precisely, the programming problem is to store all 
possible numbers in succession Into location 0009. 

Next, we break the problem up into pieces, at the same time 
deciding what registers or memory locations to use in the program for 
storage of data. In the example, there is only one piece of data that 
we are concerned with: the color we are about to display. We will 
use the X register of the computer to store this number. (The 
registers as well as the internal organization of the 6502 
microprocessor are described In Chapter 3») Thus the steps to solve 
this simple programming problem are: 

A) Put 0 into the X register. 

B) Store the X register into location 0009 (to start with color 

0 ). 

C) Add 1 to the X register (to go on to the next color). 

D) Jump back to step (B) (so that steps B and C will be repeated 
to go through all the colors. Refer back to Chapter 1 if you 
have forgotten what a Jump is.) 

Note carefully how the program works. The first time Step B Is 
executed there will be a value of zero In the X register, and thus 

color zero will be stored in location 0009 and displayed. The next 

time Step B is executed the X register will contain 1 (because 1 was 
added to the X register in Step C), and thus oolor 1 will be 

displayed. The next time around the X register will contain 2 

(because another 1 was added to the X register the second time Step C 
was executed), and so color 2 will be displayed. The program will 
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step through all the numbers, and therefore all the colors. (In case 
you are wondering what happens when the X register counts up to FF (or 
255 in decimal), the largest number that it can contain, it will 
return to zero and repeat the sequence of colors over again.) 

This programming technique of executing the same Instructions 
over and over again for different values of data (in this case for 
different numbers in the X register) is called a loop. Such loops are 
an extremely Important programming tool. You will find them in 
virtually all the example programs and will find them to be very 
useful In writing your own programs. Three essential ingredients that 
are present in any loop are shown in their simplest forms in Steps B, 
C, and D of the example: 

1. Do something (here Step B which displays a color). 

2. Change the value of the data (here Step C which changes the 
value of the X register). 

3. Oo back to the start of the loop to do it again (here Step D 
whioh jumps back to Step B to repeat the loop). 

Most loops also have a fourth element which is not present in this 
simple example: a check to see whether the program has gone through 
the loop enough times and should go on to something else. You will 
see this element of loops in future examples. 

Finally, you are ready to translate each of the steps in the 
program into specific machine language instructions to the computer. 
In the simple example each step will correspond to one computer 
instruction. In more complicated examples, as you become more 
proficient in programming, each step will normally correspond to 
several computer instructions. The complete set of instructions that 
the 6502 computer can execute is given in Chapter 3* For now, you 
will learn the instructions a few at a time as you go through the 
sample programs. In each case the introduction of an instruction will 
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include the abbreviation for the instruction, the two digit hex code 
which is the actual machine language version of the instruction, and a 
brief description of what the instruction does. Again, for more 
details see Chapter 3. 

LDX I A2 Load X register immediate: this instruction puts the 

two-digit hex number following A2 In the program into the 
X register. 

STX 8E Store X register: this instruction puts the contents of 
the X register Into the memory location whose 4-dlgit hex 
address follows 8E in the program. 

INX E8 Increment X register: this instruction adds 1 to the X 
register. 

JMP 4C Jump: this instruction Jumps to the memory location whose 
address follows 4C in the program and continues exeoutlng 
Instructions at the new memory location. 

Using these Instructions, the sample program is as follows (store the 

program in the computer starting at memory location F100, In the RAM, 

as Indicated In the first column): 

address instruction machine code comment 

F100 LDX I 00 A2 00 Put 00 into X register 

F102 STX 0009 8E 09 00 Put X register into 0009 

F105 INX E8 Add 1 to X register 

F106 JMP F102 4C 02 FI Jump back to F102 

A few points should be noted about this program. The first 
instruction is stored at location F100. The address of each 
subsequent instruction is determined by adding the length of the 
previous Instruction to the address of the previous instruction. For 
example, the first Instruction consists of the two bytes A2 and 00, 
which occupy memory locations F100 and P101. The second instruction 
goes in location F102. It is three byte3 long (8E, 09, and 00) and so 
the third instruction will go in location F1Q5, etc. You don't need 
to know all of these addresses to store the program in memory, since 
that is done Just by repeated pressing of the "Store" key which 
automatically stores into successive memory locations. You do need to 
know the addresses of any Instructions to which the program will Jump 
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so that you can code the Jump instructions. In the example, you need 
to know that the STX instruction is at location FI02 so you can have 
the program Jump to that instruction. Finally, note that when memory 
addresses (0009 and F102 in the example) are translated into machine 
oode, the order of the bytes is reversed. For example, address F102 
in the JMP instruction is entered as 02 first, and then FI. This is 
the way the 6502 expects to find its addresses. 

You are now ready to store the program into memory and run it. 
As a reminder, the sequence of steps to store the program is: 

1. Type in F100 

2. Press "Store Address" 

3- Type in A2, press "Store" 

4. Type in succession 00,8E,09,00,E8,4C,02, and FI, pressing 
"Store" after each two-digit hex number. If you have done 
this correctly, when you are done the TV display should read 
FI08 02F1 . 


Before running the program, it is a good idea to check the 
contents of memory to verify that the program was stored correctly. 
You could do this by fetching bytes from memory one at a time as 
described above, but there are two easier ways to do this by using the 
"Hex Gump" and "Ins Dump" keys. To use the Hex Dump feature, use the 
following sequence: 

1. Type in F100 

2. Press "Fetch Address" 

3. Press the "Shift" key (0 on the right controller) 

4. Press the "Hex Dump" key ( on the left controller). You will 
see an address (F100) together with two bytes of data (A2 00) 
on the bottom line of the TV. The two bytes are the contents 
of F100 and F101. 


Press "Hex Dump" again. You will see a new lino with an 
address (FT02) and the contents of the next two memory 
locations (8E 09). 
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6. Continue pressing "Hex Dump" to examine the remainder of the 
program. When you have gone through the entire program, be 
sure to press "Unshift" (the 0 key on the left controller) to 
return to normal mode. You will know you are In normal mode 
because the cursor, the little square in the top center of 
the TV, will begin blinking again. 


To use the Instruction Dump feature, use the 3ame sequence but 
press the "Ins Dump" key (key 8 on the left controller) instead of the 
"Hex Dump" key. Now you will see the abbreviation for the actual 
instruction, Just as you coded the program above. (Again make sure to 
press "Unshift" when you are finished looking at the whole program.) 


Finally, you are ready to run the program! The sequence of steps 
is as follows: 

1. Type in F100 

2. Press "Store Address" key 

3. Press "Shift" key 

4. Press "Run" key (1 key on left controller). At this point 
the MaglCard gives you a ohance to stop the run sequence to 
prevent you from inadvertently running a program before you 
are ready. The screen will go blank and wait for you to 
press either the "Game Reset" or "Game Select" switches on 
the game console. Pressing the "Game Reset" switch will 
return you to the monitor, in case you were not really ready 
to run the program. However, here you are ready to run, so 

5- Press the "Game Select" switch to begin execution of the 
program. 


You should now see a brilliant display of colors on your TV. 
Congratulations, you have run your first program! 

What next? You'll probably get tired of watching the colors 
fairly soon and will want to go on to bigger and better programs, but 
there are still a few things you can learn from this simple example. 
For one thing, how can you stop the program and get back to the 
monitor? The answer is, you can't! The program does not contain any 
instructions to stop, and so there is no way for it to stop. It will 
Just keep running, showing the colors over and over again, until you 
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turn your computer off. In the future, It will be useful to put 
instructions into your programs to allow them to stop, so this is the 
first modification to make to the sample program. As part of the 
loop, check the "Game Reset” switch, and if it is pressed leave the 
color display program and go back to the monitor program. The 


modified program looks like this: 


F100 LDX I 00 

F102 STX 0009 

F105 INX 

F106 LDA 0282 

F109 AMD I 01 

FI0D BNE 01 

F10D BRK 

F10E JMP FI02 


A2 00 
BE 09 00 
E8 

AD 82 02 These four instructions test the 
29 01 game reset switch and Jump back to 

DO 01 the monitor (via the BRK instruction) 

00 if game reset is pressed 

kC 02 FI 


Try typing this in and running it. (You'll have to turn the 
computer off and then back on again to get the original example 
program to stop.) You will again see the display of colors, but now, 
if you press the "Game Reset" switch while the program is running, the 
program will Jump back to the monitor program (I'll explain how this 
works in a moment). The monitor will as usual identify itself with 
cMx-2 In the middle of the TV and with the blinking cursor at the top. 
To restart the program, Just key in F100, press "Store Address", 
"Shift", "Run", and "Game Select", and you should see the display of 
colors again. To return to the monitor again, press "Game Reset". 
You should be able to go back and forth between the color display 
program and the monitor as many times as you like. 


Now think about what it is that this new version of the program 
did. The new instructions you used (again see Chapter 3 for detailed 
descriptions) are: 


LDA AD Load Accumulator: The accumulator is another one of the 
registers in the 6502 CPU, like the X register. This 
instruction puts the contents of the memory location whose 
address follows AD into the accumulator. In the example, 
the address is 0282. 
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AND I 29 


And Immediate: This Instruction takes the logical and of 
the immediate byte with the accumulator and puts the 
result back In the accumulator. The immediate byte is the 
byte following 29. 


BNE DO Branch if not equal: This is the first example of a 
conditional Instruction; that Is, an Instruction that 
does one of two different things depending on some 
condition. In this case, the condition is whether or not 
the last Instruction produced a result equal to zero. If 
it did, this instruction does nothing and the program 
continues with the next instruction in sequence after the 
BNE instruction. If the result of the previous 
instruction wa3 not equal to zero, a branch occurs. A 
branch is like a Jump, causing the program to Jump off to 
a location different than the one next in sequence. 
Branches differ from Jumps in that they tell the program 
how far to Jump rather than where to Jump, as JMP 
instructions do. In the example, the byte after DO in the 
program Is 01, meaning that if the condition for the 
branch is satisfied (here if there was a not zero result 
from the last instruction), It Jumps 01 bytes; that is, 
It Jumps past the BRK Instruction and executes the JMP 
F102 Instruction Instead. To summarize: 


If the last result was: then: and next is: 


equal no branch BRK 

not equal branch JMP FI02 

BRK 00 Break: This instruction causes the program to stop 

whatever It is doing and automatically Jump to a 
predetermined location. In your MagiCard system this 
location is the monitor program. Thus, executing a break 
instruction is a quick and easy way of getting back to the 
monitor. 


Now you can see how this new program works. The LDA 0282 
instruction puts the contents of memory location 0282 into the 
accumulator. This is a special location in the input/output section 
of your computer (see Chapter 6 for a detailed explanation) which 
contains the values for the various switches on the game console. The 
"AND I 01" instruction selects the first bit only (which corresponds 
to the "Game Reset" switch) for testing. (If you don't know what a 
bit is, see below.) The BNE instruction than does different things 
depending on whether or not you press tne "Game Reset" switch. If you 
do not press the switch, you will get a not equal to zero result from 
the AND Instruction. Thus the program will take the branch, skip the 
BRK instruction, and continue to execute the color display program. 
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On the other hand, if you have pressed the switch, you will get an 
equal to zero result from the AND. The program will not take the 
branch and thus will execute the BRK instruction and return to the 
monitor. (By the way, you can check the position of the other 
switches In the same manner by using "AND I 02" for the "Game Select" 
switch, "AND I 80" for the "Right Difficulty" switch, "AND I 40" for 
the "Left Difficulty" switch, and "AND I 08" for the "TV Type" switch. 
In all cases you get a not equal to zero result from the AND if the 
switch is up and an equal to zero result if the switch is down.) 

Such conditional branches as used in this example are another 
extremely important programming tool. They provide the way a program 
can make decisions and alter Its actions, baaed either on an external 
event like the setting of a switch or on the result of an internal 
computation. For example, conditional branches are the normal way for 
loops to oheck on whether or not they should be executed again. You 
will see conditional branches used repeatedly in the sample programs 
In the next section. 

Finally, a note about bits and bytes. As you probably know, 
computers do not actually U3e hexadecimal numbers, but rather binary 
(or base-2) numbers, where the only digits are zero and one. This Is 
a particularly convenient number system for oomputers because zero and 
one can correspond to the "off" and "on" states of an electronic 
circuit. All information in a computer is nothing more than a long 
string of "ons" and "offs", ones and zeros. Hexadecimal is a useful 
shorthand for programmers because of the close correspondence between 
hex and binary numbers, as can be seen from the following chart of the 
binary (and decimal) equivalents of the hex digits: 
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decimal hex binary 

0 0 0000 

1 1 0001 

2 2 0010 

3 3 0011 

<4 N 0100 

5 5 0101 

6 6 0110 

7 7 0111 

8 8 1000 

9 9 1001 

10 A 1010 

11 B 1011 

12 C 1100 

13 D 1101 

14 E 1110 

15 F 1111 


You oan see that each hex number corresponds to a unique 
four-digit binary number. Each hex digit is four binary digits, or 
bits (bit being an abbreviation for binary digit). A byte, or two hex 
digits, is 8 bits. Thus, each location in the computer's memory Is 
actually a collection of 8 little electronic circuits, each of which 
can be Individually turned on and off, corresponding to 8 bits or 1 
byte. As the 8 bits take on all possible values of on and off, they 
produce all possible combinations of two hex digits (all the hex 
numbers from 00 to FF, or all the decimal numbers from zero to 255). 


For example, the decimal number 171 in hexadecimal is AB (see the 
chart in Appendix A), and the binary equivalent of AB is 1010 1011 
(see chart above). Thus decimal 171, or hex AB, i3 represented in the 
computer as a byte with bits 0,1,3,5, and 7 on (starting from zero and 
counting from the right), and bits 2,4, and 6 off. Bits and bytes 
will be referred to in Chapter 3 in the discussion of the 6502 


microprocessor. 
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2.5 USING MONITOR SUBROUTINES 

You are now ready to write more complex sample programs using 
another important programming tool, subroutines. A subroutine 13 
simply a section of your program that you need to execute fairly 
often. Rather than repeat the same instructions over and over again 
at different places in your program, you put the instructions in one 
place only. At all the places where you want to execute that whole 
set of Instructions, you put the single instruction JSR (Jump to 
Subroutine} with the address of the one place where the set of 
instructions begins. This will cause the program to Jump off and 
execute the set of Instructions (the subroutine). At the end of the 
subroutine a special instruction, RTS (Return Trom Subroutine), forces 
a Jump back to the instruction following the JSR, where execution 
continues. 

A number of especially useful subroutines are contained in the 
monitor program and are available to the user. They are fully 
described in Chapter 7. A few of them are used in the following 
sample programs to illustrate display of both text and graphics on the 
TV screen. A complete description of all the Instructions used in 
these programs will not be given here, since full details on all 6502 
instructions are given in Chapter 3> Instead full listings of the 
programs will be given, ready to be keyed in and/or modified to suit 
your own purposes. Descriptions of what the programs do, and comments 
on various parts of the programs where new things are Introduced are 
also provided. 

Example 1 displays the full MagiCard character set on your TV 
screen using the monitor subroutines DOLN and DSPL. As explained in 
Appendix B, each hex number from 00 to 3F represents a unique 
character. This program displays all the characters by putting all 



USING YOUR MAGICARD 


Page 2-21 


these hex numbers Into the display area of memory (locations 98-Ai). 
This Is first done In the loop starting at location LOOP, where the 
numbers from 00 to 0? are stored into locations 98 to A1. Note the 
use of the X register as an index register in the "STA X 98" 
instruction, which stores into a different memory location for each 
value of the X register. As the X register takes on all values from 
00 to 09, these numbers are successively stored into 98, 99, 9A, etc. 
as the program goes through the loop. The loop ends when the X 
register reaches 0A, and the "JSR DOLN" instruction Jumps to 
subroutine DOLN which displays the first line of characters. Location 
8F is then Increased by one to point to the next line of the display, 
and locations 98 through A1 each have 0A added to them (in the loop 
starting at location L0OP2, again using indexed addressing mode), to 
move on to the next set of ten characters (in this case characters 0A 
through 13)* This prooess continues until all 7 lines have displayed, 
whereupon the program Jumps to location DONE. Here It Just 
continuously calls DSPL to continue showing the same display on the TV 
until you hit the "Game Reset" switch, which will return you to the 
monitor. (You don't need to put code to check for the "Game Reset" 
switch Into your program because this Is automatically done by the 
DSPL subroutine.) 

Example 2 is a modification of the first program which allows you 
to typo messages on the TV screen using the keyboard controllers. 
Keys 1-9 on the left controller represent letters A-Ij keys 1-9 on 
the right controller represent J-R; pressing key 0 on the right 
controller puts you in shift mode, whereupon keys 1-9 on the left 
controller represent S-Z and blank. Key 0 on the left controller 
takes you out of shift mode again. This program again uses DSPL to 
put up the display and also to read the keyboard controllers, and uses 
subroutine ONEC to put one character at a time onto the display as you 
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enter then on the keys. Note the use of certain memory locations to 
save data during the course of the program; location BO contains the 
line number of the character being displayed, El contains the position 
within the line, and E2 is a flag remembering whether or not you are 
in shift mode. E2 contains 0 when In unshift mode and 12 when in 
shift mode. Studying these two examples should enable you to write 
your own programs to display text on the TV screen. 

Example 3 shows how to use the CALP subroutine in conjunction 
with STPM and DSPL to produce graphic displays. It is a target 
practice game using the left controller only. Key 4 moves your cannon 
to the left, key 6 moves your cannon to the right, and key 0 fires a 
bullet at the moving targets. Note the use of subroutines within the 
main program (OFF to turn a point off and ON to turn a point on), and 
the use of the sound registers in the video display generator to make 
noises when a bullet is fired and when a hit is made. Also note the 
extensive use of memory locations to store variables (locations 
EO-EC), as explained in the comments in the program listing. You can 
easily modify this program to add multiple targets, to keep score at 
the top of the screen using the text display routines, and to use both 
controllers to allow for two different players, each having a cannon 
and competing for high score. 

Finally, Example U shows you how to run the TV display without 
using monitor subroutines. It makes all the appropriate stores to 
locations in the video display generator to synchronize the TV 
picture. A program can make changes to the various display registers 
of the display generator in the course of execution to change the 
picture being displayed. In the example this is done in two plaoes; 
during L00P3, the pattern is changed in location OE and the right-side 
color is ohanged in location 07 between lines of a single TV picture; 
and in the major loop of the program running from START to L00P2, the 
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left-aide color la changed in location 06 and the pattern la changed 
in location OF between frames of the TV picture. You can easily aee 
theae two types of changes as you watch the TV: the right-aide color, 
for example, changes each line of the display; while the left-aide 
color only changes from one TV picture to the next. 3y making 
modifications of this program, you will be able to make displays of 
various types of objects that move around on the TV screen and begin 
to duplicate the video effects of game cartridges. 
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Example 1: Display of Character Set 


START LDA I 00 
STA 008F 
LDX I 00 
LOOP TXA 

STA 7.X 98 
INX 

CPX I OA 

BNE LOOP 
DISP JSR DOLN 

LDX 008r 

5TX 008F 
CPX I 07 
BEQ DONE 
LDX I 00 
CLC 

LOOP2 LDA ZX 98 
ADC I OA 
STA ZX 98 
INX 

CPX I OA 
BNE L00P2 
JMP DISP 
DONE JSR DSPL 
JMP DONE 


F100 A9 00 0 to accumulator 

8D 8F 00 0 to 8 f (line of display) 

A2 00 0 to X reg. (character position) 

F107 8A transfer X reg to acc. 

95 98 store acc. in display area of men. 
E8 increment X reg. 

EO OA compare X reg with OA (to see if 
line done) 

DO F8 branch back to loop if not done 
F10F 20 C8 FC Jump to display line subroutine 
AE 8F 00 put line # in X reg 
E8 add 1 to X reg 

8E 8F 00 put new line 9 back in 8F 
EO 07 check if ail lines finished 

FO 11 Jump to done if all lines finished 

A2 00 0 to X (character position) 

18 clear carry (for add instruction) 

F120 B5 98 get old character to accumulator 

69 0A add A to character to make new one 
95 98 store new character in display mem. 
E8 

E0 0A check if done with line 
DO F5 branch back to loop2 if not done 
AC OF FI Jump to disp if done 
F12E 20 6F FA Jump to dspl subroutine 

Ac 2E FI . Jump back to done to repeat 

display until game reset is hit 
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Example 2: Memo Pad 


START LDX I 00 FI00 A2 00 

STX Z EO 86 EO 

STX Z El 86 El 

STX Z E2 86 E2 

DISP JSP DSPL FI08 20 6F FA 

LDA Z 83 A5 83 

BPL RIGHT 10 HA 

LDA Z 82 AS 82 

BMI DISP 30 F5 

LEFT BNE LCHAR F113 DO 07 

UNSHFT LDX I 00 F115 A2 00 

STX Z E2 86 E2 

JMP DIS? HC 08 FI 

LCHAR CLC F11C 18 

ADC E2 65 E2 

CMP I IB C9 IB 

BNE NTBLNK DO 02 

LDA I 20 A9 20 

NTBLNK STA Z E3 FI25 85 E3 

NEWCHR LDX Z EO F127 A6 EO 

STX Z 8F 86 8F 

LDX Z El Ao El 

STX Z 8E 86 8E 

LDA Z E3 A5 E3 

STA ZX 98 95 98 

JSR ON EC 20 67 FB 

LDX Z El A6 El 

INX E8 

STX Z El 86 El 

CPX I OA EO OA 

BNE DISP DO C9 

LDX I 00 A2 00 

STX Z El 86 El 

LDX Z EO A6 EO 

INX E8 

STX Z EO 86 EO 

CPX I 07 EO 07 

BNE DISP DO BC 

LDX I 00 A2 00 

STX Z EO 86 EO 

JMP DISP HC 03 FI 

RIGHT BNE RCHAR F153 DO 07 

SHFT LDX I 12 A2 12 

STX Z E2 86 E2 

JMP DISP HC 08 FI 

RCHAR CLC F15C 18 

ADC I 09 69 09 

STA Z E3 35 E3 

JMP NEWCHR HC 21 FI 


0 to X reg 
0 to EO (line #) 

0 to El (position In line) 

0 to E2 (shift flag) 

Jump to dspl subr. to display 

a line and read keyboard controllers 
right keyboard byte to acc. 
branch to right If key was hit 
left keyboard byte to acc. 
branch back to dlsp If no key was hit 
branch to lchar If char key was hit 
unshift key W3s hit; 0 to X reg 
0 to E2 
Jump to dlsp 

char key was hit; clear carry 
add shift flag (0 or 12) to char 
check If blank character 
branch If not blank 
put code for blank (20) in ace. 
acc to E3 (new character to E3) 
line # to X reg 
line t to 8F 

position in line to X reg 

position in line to BE 

character to accumulator 

store character in right location in 

memory for one character display subr. 

jump to one char subroutine 

position In lino to X reg 

add 1 to X reg 

new position to Si 

check IT at end of line 

branch back to dlsp if not end of line 

0 to x reg 

0 to El (start of new line) 

line » to X reg 

add 1 to X 

new line # to £0 

check for last line on screen 

jump back to dlsp if not last line 

0 to X reg 

0 to E0 (restart with line 9 0) 

Jump back to dlsp to continue 
check for new char on right controller 
shift key was hit; 12 to X reg 
store 12 in E? (to shift characters) 
jump back to di3p 

new character on right; clear carry 
add 9 to acc to convert char 
store new char in E3 
Jump to newchr to put up new char 
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Example 3: Target Practice 


STX Z 8D 
LDY I 00 
TYA 

STY Z 8C 
LOOP1 JSR ST PM 
INY 

CMY I D2 
BNE LOOP! 
STA Z E3 
STA Z EA 
LDA I F8 
STA Z EB 
LDA I U 
STA Z EO 
LDA I 02 
STA Z E7 
LDA I 28 
STA Z 8F 
LDA Z EO 
STA Z 8E 
JSR ON 

NEWTRG LDX I 00 
STX Z E9 
LDA X) EA 
INC Z EA 
TAX 

AND I OF 
ADC I 10 
STA Z E5 
TXA 
ROR 
ROR 
ROR 
ROR 

AND I 03 
ADC I 01 
STA Z E6 
STA Z E8 
DISP JSR DSPL 

DEC Z EC 
BPL ARND 
LDA I 00 
STA Z 16 
ARND LDA Z 8a 

BMI NOKEY 
BEQ FIRE 
CMP I 05 
BPL RIGHT 
LEFT LDA Z EO 

BEQ NOKEY 
STA Z 8E 
LDA I 28 
STA Z 8F 
JSR OFF 
DEC Z EO 
DEC Z 8E 


F100 

F109 

Fill 


F12C 


F1 *18 


F153 


F15D 


A2 F*1 
86 8D 
AO 00 
98 

84 8C 

20 F7 FF 
C8 

CO D2 
DO F8 

85 E3 
85 EA 
A9 F8 
85 EB 
A9 tH 
85 EO 
A9 02 
85 E7 
A9 28 
85 8F 
A5 EO 

85 8E 

20 15 F2 
A2 00 

86 E*J 
A1 EA 
E6 EA 
AA 

29 OF 
69 10 
85 E5 
8A 
6A 
6A 
6A 
6A 

29 03 
69 01 
85 E6 
85 E8 

20 6F FA 
C6 EC 
10 0*1 
A9 00 
65 16 
A5 8A 

30 52 
FO 3*1 
C9 05 
10 17 
A5 EO 
FO *18 
85 BE 
A9 28 
85 8F 

20 IF F2 
C6 EO 
C6 8E 


set up 8C and 8D for stpm 


loop to clear TV display 
by storing 00 in F100-F1D2 
using stpm subroutine 

Initialize variables; 0 to E3 
0 to EA (EA and EB are address for 
random number generated by 
F8 to EB reading a loc in monitor) 
1*1 to EO (starting horizontal pos 
of cannon) 

02 to E7 (speed of bullet) 

28 is vertical pos of cannon 
turn on cannon by putting hor. 
and vert, position in 8E and 8F 
and calling subroutine on 

new target; 00 to E 1 * (hor. pos.) 

get a random Instruction from mon. 

save aco in X reg 
calculate target v position 

store targ v position 
get acc back from x reg 
shift right four bits 


calculate target speed 

target speed to E6 
and E8 (target speed counter) 

Jump to display subr. 
cheek sound counter 

turn off sound 

read left keyboard controller 
and Jump to nokey if no key hit 
Jump to fire If 0 key hit 
cheok whether left (key *0 or 
right (key 6) movement wanted 
get cannon horizontal pos. 
and Jump to nokey if at left edge 


turn off old cannon position 
move cannon one pos. left 
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JSR ON 
JMP NOKEY 
RIGHT LDA Z EO 
CMP I 27 
BEQ NOKEY 
STA Z 8E 
LDA I 28 
STA Z 8F 
JSR OFF 
INC Z EO 
INC Z 3E 
JSR ON 
JMP NOKEY 
FIRE LDA Z E3 
BNE NOKEY 
INC Z E3 
LDA I 27 
STA Z E2 
STA Z 8F 
LDA Z EO 
STA Z El 
STA Z 8E 
JSR ON 
LDA Z E7 
STA Z E9 
JSR DSND 
NOKEY LDA Z E3 

BEQ NOBULL 
DEC Z E9 
BNE NOBULL 
LDA Z E7 
STA Z E9 
LDA Z El 
STA Z 8E 
LDA Z E2 
STA Z 8F 
JSR OFF 
DEC Z E2 
BM1 TOP 
DEC Z 8F 
JSR ON 
JMP NOBULL 
TOP LDA I 00 
STA Z E3 
NOBULL DEC Z E8 
BNE NOMOVE 
LDA Z E6 
STA Z E8 
LDA Z EM 
STA Z 8E 
LDA Z E5 
STA Z 8F 
JSR OFF 
LDX Z EM 
CPX I 27 
BEQ JUMPNT 
INX 

STX Z EM 
STX z be 
JSR ON 


F17*< 


Fl8D 


F1A9 


F1CC 

FIDO 


F1P1 


20 15 F2 
4C A9 FI 
A5 EO 
C9 27 
FO 2F 
85 8E 
A9 28 
85 8F 
20 IF F2 
E6 EO 
E6 8F. 

20 15 F2 
MC A9 FI 

(is E3 

DO 18 
E6 E3 
A9 27 
B5 E2 
35 8F 
A5 EO 
85 El 
85 8E 
20 15 F2 
A5 E7 
85 E9 
20 2B F2 
A5 E3 
FO 23 
C6 E9 
DO IF 
A5 E7 
85 E9 
A5 El 
85 8E 
A5 E2 
85 8F 
20 IF P2 
C6 E2 
30 08 
C6 8F 
20 15 F2 
MC DO FI 
A9 00 
85 E3 
C6 E8 
DO ID 
A5 E6 
85 E8 
A5 EM 
85 8E 
A5 E5 

85 8f 

20 IF F2 
A6 EM 
EO 27 
FO 26 
E8 

86 EM 
66 8E 

20 15 F2 
A5 El 


turn on new cannon position 
Jump to nokey to continue 
got cannon hor. pos. 
check IT at right edge 
and Jump to nokey If yes 


turn off old cannon position 
move cannon one pos. right 

turn on new cannon position 
Jump to nokey to oontinue 
check if bullet already fired 
and Jump to nokey if yes 
turn on bullet fired flag 
starting bullet vort. pos. 
bullet vert. pos. to E2 

get cannon hor. pos. for 
starting bullet hor. pos. 

turn on bullet 
get bullet speed to 
bullet speed counter 
make bullet sound 
check If bullet fired 
and Jump to nobull If not 
decrement bullet speed counter 
and Jump IT not time to move 
restore bullet speed counter 

bullet hor. pos. 

bullet vert. pos. 

turn off old bullet position 
move bullet up one position 
jump to top if at top of screen 

turn on new bullet position 

turn off bullet fired flag 
by putting 00 into E3 
decrement target speed counter 
and Jump if not time to move 
restore target speed counter 

target hor. pos. 

target vert. pos. 

turn off old target position 

oheck if target at right edge 
and Jump to newtrg if yes 
move target one position right 


turn on new target position 
compare target and bullet 
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CMP Z E4 CS E4 horizontal positions 

BNE JMPDSP DO IB and Jump to dlsp if different 

LDA Z E2 A5 E2 compare target and bullet 

CMP Z E5 C5 E5 vertical positions 

BNE JMPDSP DO 15 and Jump to dlsp If different 

JSR HITSND 20 3A F2 hit!! make hit sound 

LDA Z El A5 El 

STA Z 8E 85 8E 

LDA Z E2 A5 E2 

STA Z 8F 85 8F 

JSR OFF 20 IF F2 turn of bullet and target 

LDA I 00 A9 00 

STA Z E3 85 E3 turn off bullet fired flag 

JUMPNT JMP NEWTRG F20F 4C 2C FI Jump to newtrg 

JMPDSP JMP DISP F212 4C 48 FI Jump to dlsp 

ON JSR CALP F215 20 BE FF on subr; Jump to calp 

ORA Y F000 19 00 F0 or new bit on 

JSR STPM 20 F7 FF Jump to stpm 

RTS 60 end of subroutine; return 

OFF JSR CALP F21F 20 BE FF off subr; Jump to calp 

EOR I FF 49 FF 

AND Y F000 39 00 FO and new bit off 

JSR STPM 20 F7 FF Jump to stpo 

RTS 60 end of subroutine; return 

BSND LDA I FF F22B A9 FF bullet sound subroutine 

STA Z 1A 85 1A load sound registers 

LDA I 22 A9 22 

STA Z 18 85 18 

STA Z 16 85 16 

LDA I 20 A9 20 

STA Z EC 85 EC set up sound oounter (EC) 

RTS 60 end of subr, return 

HITSND LDA I 77 F23A A9 77 hit sound subroutine 

STA Z 16 85 16 load sound register 

LDA I 20 A9 20 

STA Z EC 85 EC set up sound counter 

RTS 60 end of subr, return 
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Example 4: Generating Your Own Display 


START 

LDA 

2 81 

F200 

A5 

81 


oontents of 81 to ace 


STA 

Z OF 


85 

OF 


save new pattern in OF 


LDA 

I 03 


A9 

03 


3 to acc 


STA 

2 OA 


85 

OA 


3 to OA 


LDA 

I 55 


A9 

55 


55 to acc. 


STA 

2 07 


85 

07 


55 to 07 (right aide color) 


LDY 

I 00 


AO 

00 


0 to Y reg 


DEY 



88 



decrement y reg 


STA 

Z 02 


85 

02 




STY 

2 01 


84 

01 


start V blank 


STY 

2 00 


84 

00 


start V sync 


LDA 

I 2A 


A9 

2A 


2A to acc 


STA 

0295 


8D 

95 

02 

atore 2A into timer 

LOOP! 

LDY 

0284 

F21A 

AC 

84 

02 

load timer to y and wait 


BNE 

LOOP! 


DO 

ra 


for it to run out 


STY 

Z 02 


84 

02 




STY 

Z 00 


84 

00 


end V sync 


LDA 

I 24 


A9 

24 


24 to acc 


STA 

0296 


8D 

96 

02 

load timer 


LDA 

0282 


AD 

02 

03 

switches to acc 


AND 

I 01 


29 

01 


look at game reset switch 


BNE 

NORSET 


DO 

01 


branch if switch not hit 


BRK 



00 



break to monitor if reset hit 

NORSET 

INC 

Z 80 

F230 

E6 

80 


increment location 80 


BNE 

LOOP 2 


DO 

OA 




LDA 

I EO 


A9 

EO 


EO to acc 


STA 

2 80 


85 

80 


EO to 8C to reset counter 


INC 

Z 81 


E6 

81 


increment loc 81 (color) 


LDA 

2 81 


A5 

Bl 


new color to acc 


STA 

Z 06 


85 

06 


new color to 06 (left side color) 

LOOP2 

LDY 

0284 

F23E 

AC 

84 

02 

wait for timer 


BNE 

L00P2 


DO 

FB 




STY 

Z 02 


84 

02 


start of TV scan line 


STY 

Z 01 


84 

01 


end V blank 


LDX 

I E4 


A2 

E4 


E4 to X reg 

LOOP 3 

STY 

Z 02 

F249 

84 

02 


start of TV scan line 


STX 

Z OE 


86 

MS 


new pattern to OE 


STX 

Z 07 


86 

07 


new color to 07 (right side color) 


DEX 



CA 



decrement X reg 


BNE 

L00P3 


DO 

F7 


Jump back to loop3 for 








next line of TV picture 


JXP 

START 


4C 

00 

F2 

Jump back to start 



CHAPTER 3 


Description of 6502 Mioroprooessor 

This chapter gives a complete description of the 6502 
microprocessor. It Is assumed that those who read this chapter have a 
good general understanding of computer concepts (such as bytes, bits, 
hexadecimal, registers, memory, and instructions). Although an effort 
has been made to make this MagiCard manual as complete as possible, 
you may find it necessary to read some additional material on 
microcomputers to fully understand the material in this chapter. You 
should be able to find several books on the 6502 in any small computer 
store. An excellent example is the book Programming The 6502 . third 
edition by Rodnay Zaks. 


3.1 Ceneral Description 

The 6502 microprocessor is a general purpose 8 bit microprocessor. 
The processor contains six registers—one accumulator, two index 
registers, a stack pointer, a processor-status register, and a program 
counter. A maximum of 65,536 bytes of memory can be used with the 
6502 although the design of the ATARI Video Computer System limits the 
size of a MagiCard program to about 102 1 * bytes. The 6502 has an 
instruction set of sixty-five instructions and thirteen addressing 
modes (many of which can be used with only a few instructions). All 
6502 instructions are either one, two, or three bytes in length. The 
first byte of the instruction (the "opcode") specifies the operation 
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to be performed while the second and third bytes (if prosent) provide 
either data for the instruction or the address of a memory location to 
be referenced by the instruction. 

Section 3*2 describes the 6502 registers. Section 3.3 describes 
the format of 6502 instructions Including a detailed description of 
the possible addressing nodes. Finally, Section 3.*4 describes the 
operation of each of the 6502 instructions. 


3.2 Description of 6502 Registers 

The names, abbreviations, and lengths of the 6502 registers are given 
below: 


Register Name 

Abbreviation 

Length 

Accumulator 

A 

8 bits 

X index register 

X 

8 bits 

Y index register 

Y 

8 bits 

Stack pointer register 

S 

8 bits 

Processor status register 

P 

8 bits 

Program Counter 

PC 

16 bits 


The use of each of the registers will now be discussed in more detail. 


3.2.1 Accumulator 

The accumulator is U3ed primarily to perform arithmetic and logical 
operations on data. 


3.2.2 X and Y Index Registers 

The index registers are used to specify an offset (index) into a table 
of data and as counters. 
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3.2.3 Stack Pointer Register 

The stack pointer contains the address of the next memory location 
available on the "stack". The stack is an area of memory (confined on 
your ATARI game to addresses between 80 and FF) that is used for the 
temporary storage of data. In particular, the stack is used as part 
of the 6502 subroutine calling procedure (see description of JSR and 
RTS instructions in Section 3.4.11) and the 6502 "break" mechanism 
(see description of the BRK instruction in Section 3.4.15). 

Bytes of data may be placed on the stack ("pushed") one at a time 
and, at some future time, removed from the stack ("pulled") one at a 
time in the opposite order in which they were pushed. Pushing a byte 
onto the stack causes the byte to be stored in memory at the address 
contained in the stack pointer, after which the stack pointer is 
decremented by one. Pulling a byte from the stack is the inverse of 
pushing—the stack pointer is incremented by one, and the address now 
in the stack pointer is taken as the address of the byte to be 
removed. Because of the way the "push" and "pull" operations arc 
defined, the stack grows from larger addresses to smaller ones. For 
this reason, the stack pointer is usually set to an initial value of 
FF. 

3.2.4 Processor-Status Register 

The processor-status register contains a collection of status flags. 
Each flag has two possible values—a value of one (indicating that the 
riag is "set") or a value of zero (indicating the the flag is 
■clear"). Depending on the particular flag, the value of a flag is 
either altered by Including a special instruction in the program, or 
altered automatically by the microprocessor to Indicate something 
about the outcome of the instruction it has Just executed. The values 
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of some of the flags can be altered in both ways. 

Those flags that are automatically altered by the microprocessor 
are called "condition codes". Depending on the particular instruction 
that has been executed, the microprocessor may alter the value of any 
or all of the condition codes. Those condition codes that are altered 
by the execution of an instruction are specified in the detailed 
description of each instruction given in Section 3- 1 *. 

The names of the flags and a short description of their use are 
given below. 


Zero Flag (or "Z-flag")— This flag is a condition code set by 

the microprocessor to indicate that a byte had a value of 

zero. 

Negative Flag (or "N-flag")— This flag is a condition code sot 
by the microprocessor to indicate that a byte had a negative 
value (l.e. f its most significant bit was a one). 

Carry Flag (or "C-flag")— This flag is a condition code set by 

the microprocessor to indicate that a logical (e.g., a 

shift) or arithmetic (e.g. y an addition) operation was 
performed that resulted in a value greater than could be 
stored in a one byte number. 

Overflow Flag (or "V-flag")— This flag is a condition code set 
by the microprocessor to indicate that the result of an 
addition or subtraction operation resulted in "arithmetic 
overflow". Arithmetic overflow occurs in an addition 
operation when two numbers with the same sign are added 
together and the result is a number with the opposite sign. 
For example, if you add the number one to the number 7F 
(hex), the result is 80 (hex). Both the number one and the 
number 7f are positive (the most significant bit in the byte 
is zero) while the number 80 is negative (the most 
significant bit in the byte is one). Thus, arithmetic 
overflow has occurred. In a similar fashion, arithmetic 
overflow occurs in a subtraction operation when two numbers 
of opposite sign are subtracted and the sign of the result 
is the same a3 the sign of the number subtracted. 

Decimal-Mode Flag (or "D-flag")— When this flag is set by the 
programmer, it tells the microprocessor to perform add and 
subtract operations in "packed decimal" mode. In packed 
decimal mode, each byte of data is treated as if it 
contained two decimal digits—the most significant digit In 
the most significant four bits of the byte, and the least 
significant digit in the least significant four bits of the 
byte. 

Interrupt-Disable Flag (or "I-flag")— When this flag is set by 
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the programmer, it tells the microprocessor that the BRK 
instruction (see Section 3.*1.15) is to be executed in the 
3aae way as the NOP instruction (sec Section 3.*1.13)—i-e. 
the BRK Instruction is essentially ignored. 

Break Flag (or "B-flag")— This flag is set by the microprocessor 
whenever the execution of a BRK Instruction has caused an 
interrupt (see Section 3*4*15) and is of essentially no 
value to users of the MagiCard. 

Each flag occupies one bit in the processor status register. The 
particular bit position of each flag is of very little Interest to the 
programmer but is included here for completeness: 


Bit Flag 

0 Carry Flag 

1 Zero Flag 

2 Interrupt-Disable Flag 

3 Decimal Mode Flag 

U Break Flag 

5 unused 

6 Overflow Flag 

7 Negative Flag 


3.2.5 Program Counter 

The program counter contains the 16-bit address of the next 
Instruction to be executed by the microprocessor. It is automatically 
updated after the execution of each instruction. 


3.3 Format of 6502 instructions 

All 6502 instructions consist of one, two, or three bytes. The first 
byte of the instruction (called the "opcode") tells the 6502 

1. What operation 1s to be performed. 

2. How may byte3 are in the instruction (l.e. one, two, or 
three). 

3. What the additional bytes in the instruction are to be used 
for. 
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The possible operations that can be performed by 6502 instructions 
will be given when the instruction set is described in Section 3.U. 
The second and third items in this list are collectively referred to 
as the "addressing mode" and will now be discussed in more detail. 

The 6502 microprocessor recognizes thirteen different addressing 
modes. Two of the addressing modes tell the 6502 that the only byte 
in the instruction is the opcode. One of the addressing modes tells 
the 6502 that there are two bytes in the Instruction and that the 
second byte contains the actual data to be used in performing the 
requested operation. For all other addressing modes, the one or two 
bytes following the opcode are used by the 6502 to calculate a 
"targot address" for the instruction. 

The exact manner in which the target address is calculated 
depends on the particular addressing mode selected. A description of 
the target address calculation is included as part of the description 
of each addressing mode given In Sections 3.3.1 to 3.3.12. The use 
that is made of the target address depends on the operation being 
performed. For example: 

If the instruction is a register load operation, the target 

address specifies the address in memory whose contents is to 
be loaded Into the register. 

If the instruction is a register store operation, the target 
specifies the address in memory into which the value in the 
register is to be stored. 

If the Instruction is a Jump operation, the target address 

specifies to what address the microprocessor is to jump. 

Many operations can be combined with more than one addressing 
mode. For example, consider the operation that shifts a byte of data 
one bit to the left. Using one of the possible 6502 addressing modes 
for this instruction, you can specify the 16-bit address of the data 

byte that is to be shifted. Alternatively, by specifying a different 
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addressing mode, you can shift a data byte that is in the accumulator. 

It is important to note that not all operations can be combined 
with all addressing modes (i.e., no opcode exists for many imaginable 
combinations of operations and addressing modes). Until you are 
familiar with the 6502, you will have to take care to Insure that a 
program you are writing does not depend crucially on a very reasonable 
(but nonexistent!) operation and addressing mode combination. 

All the addressing modes used by the 6502 are described below. 
The abbreviations for the addressing modes used by the MagiCard 
instruction dump feature (see Section <1.3) are shown within square 
brackets. 


3-3.1 [ ) "Accumulator" addressing mode or "Implied" addressing mode: 
Total instruction length is one byte. Accumulator addressing means 
that the accumulator contains the operand (data to be used by the 
instruction). Implied addressing means that the operand is implied by 
the operation itself. 


3.3*2 [I] "Immediate" addressing mode: 

Total instruction length is two bytes. The second byte of the 
instruction is the actual value of the operand. Another way to think 
of this is that the target address for the operation la the address of 
the second byte of the instruction. 


3.3.3 [A] "Absolute" addressing mode: 

Total instruction length is three bytes. The second and third bytes 
of the instruction contain the target address for the operation. The 
second byte of the instruction contains the least significant eight 
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bits of the address, and the third byte of the instruction contains 
the most significant eight bits of the address. 


3»3.^ fZ] "Zero Page" addressing mode; 

Total instruction length is two bytes. The second byte of the 
Instruction contains the target address. This mode is similar to the 
absolute addressing node except only addresses from 00 to FF may be 
referenced. 


3-3*5 (ZX) "Zero Page X Indexed" addressing mode: 

Total instruction length is two bytes. The target address is found by 
adding the second byte of the instruction to the contents of the 
X index register (only the lower eight bits of the sum are kept). 


3-3-6 CZY3 "Zero Page Y Indexed" addressing mode: 

The same as zero page X Indexed except the Y index register is used. 
Note: this mode is available for only two instructions—load X index 
register (LDX) and store X index register (STX). 


3-3-7 rx3 "Absolute X Indexed" addressing node: 

Total instruction length is three bytes. The second and third bytes 
of the instruction contain a sixteen-bit address In the same manner as 
in absolute addressing. The target address is found by adding the 
contents of the X index register to this sixteen-bit address. (Note: 
The addition of the X index register to the original sixteen-bit 
address is performed in a sixteen-bit manner. For example, if the 
second and third bytes of the instruction were C9 and FA, and the 
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contents of the X index register were AO, then the target address 
would be FAC9 ♦ AO s FB09) 

3.3*8 [Y] "Absolute Y Indexed" addressing mode. 

This mode is the same as absolute X indexed mode except the Y index 
register is used. (Note: This mode is available for fewer 
instructions than "Absolute X Indexed" mode.) 


3-3-9 [X)) "Indirect X" addressing mode. 

Total instruction length is two bytes. The second byte of this 
instruction is added to the contents of the X index register to form 
an eight-bit address (as in the (ZX) addressing mode). The contents 
of this eight-bit address and the address immediately following are 
then taken to be the target address. 

For example, assume that the second byte of an [X)J instruction 
is 80 and the contents of the X index register is 3. The contents of 
memory location 83 contain the lower eight bits of the target address, 
and the contents of memory location BA contain the upper eight bits of 
the target address. 


3.3*10 [)Y] "Indirect Y" addressing mode. 

Total instruction length is two bytes. The second byte of the 
instruction contains an eight-bit address. The contents of this 
address and the following address are taken as a sixteen-bit address 
(the least significant byte of the sixteen-bit address is in the first 
byte as in [A]). The target address is formed by adding the contents 
of the Y index register to the sixteen-bit address. 

For example, assume that the second byte of a [)Y] instruction is 
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80 and the contents of the Y index register is 2. The 6502 first 
forms a sixteen-bit address by getting its lower eight bits from 
location 80 (which we will assume contains FF) and its upper eight 
bits from location 81 (which we will assume contains F0). The 
contents of the Y index register (3) is then added to the sixteen-bit 
address (FOFF) resulting in a target address of F102. 

It is very important not to confuse [)Y] addressing with [X)] 
addressing. In practice, [)Y] is used more often and should be 
understood completely. The [X)] mode is often used with zero in the 
X index register. 


3.3.11 (()] "Absolute Indirect" addressing mode. 

Total instruction length is three bytes. The second and third bytes 
of the instruction contain a sixteen-bit address (the lower eight bits 
are in the second byte, and the upper eight bits are in the third 
byte). The location at this address contains the lower eight bits of 
the target address. The upper eight bits of the target address are in 
the next memory location. (Note: This mode is only used by the JMP 
(Jump) Instruction). 

3.3*12 [nn] "Relative" addressing mode. 

Total instruction length is two bytes. The second byte of the 
Instruction is treated as a signed two's-complement number (i.e., 
FF = -1, FE = -2, ..., 80 — -80, 7F s +7F, ...). This signed number 
is added to the sixteen-bit address of the first byto of the next 
instruction and the result is the target address. For example, assume 
that the two bytes of an instruction that uses relative addressing are 
contained in memory locations F311 and F312. Further, assume that the 
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second byte of the instruction contains FD. The target address for 
the instruction is FD ♦ F313 = -3 ♦ F313 = F310. (Note: Relative 
addressing is used only by branch instructions.) 


3-** Description of 6502 Instruction Set 

In this section, we describe all of the instructions recognized by the 
6502 microprocessor. For each instruction, the following information 
is provided: 

1. The Instruction name—a three letter mnemonic (always 
capitalized) 

2. A description of the operation performed by the instruction. 

3. An opcode value for each of the possible addressing modes 
that can be used with the instruction. 

*J. The condition codes in the program-status register that are 
modified by the instruction. 

To form a complete instruction, you first use the operation to be 
performed and the addressing mode desired to select the value of the 
opcode to be used. The opcode byte is then followed by the (possibly) 
additional bytes required by the addressing mode being used. 


NOTE 

Although there are two hundred and 
fifty-six possible eight-bit opcodes, 
many of the possibilities are not used 
by the 6502. If one of these unused 
values is accidentally included in a 
program, unpredictable (often bad) 
results will occur. 


3.*1.1 Memory Transfer Instructions 

All of the following instructions either copy ("Load") the contents of 
a memory location into a register or copy ("Store") the contents of a 



register into a memory location. 

Name Description 

LDA Load the accumulator with the contents of the specified 
memory location 

STA Store the accumulator into the specified memory location 

LDX Load the X index register with the contents of the specified 
memory location 

STX Store the X index register into the specified memory location 

LDY Load the Y index register with the contents of the specified 
memory location 

STY Store the Y index register into the specified memory location 


The opcodes for each memory-transfer instruction with each of its 
possible addressing modes are as follows: 


[ii tAi czi cxn cm rzxi rxi m mi 


LDA A9 AD AO A1 

STA — 8D 85 81 

LDX A 2 AF. A6 — 

STX — 8E 86 

LDY AO AC A4 

STY — 8C an 


B1 B5 BD B9 

91 95 9D 99 

BE B6 

. 96 

B4 BC 

94 — 


Condition Codes: 


Z-flag: set if a value of zero is loaded into a register, 

cleared otherwise (the Z-flag is not modified by store 
instructions). 

N-flag: set if a negative value Is loaded into a register, 

cleared otherwise (the N-flag is not modified by store 
instructions). 

C and V-flag3: not modified by any of these Instructions 


3.4.2 Reglster-to-Beglster Transfer Instructions 

These Instructions copy the contents of one register into another. 
Implied addressing is the only addressing mode allowed. 

Name Opcode Description 


TAX AA Copy the contents of the accumulator into the X index 

register. 

TXA 8A Copy the contents of the X index register into the 

accumulator. 

TAY A8 Copy the contents of the accumulator Into the Y index 

register. 

TYA 98 Copy the contents of the Y index register into the 
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accumulator. 

TSX BA Copy the contents of the Stack Pointer into the 

X index register 

TXS 9A Copy the contents of the X index register into the 

Stack Pointer. 


Condition Codes: 


Z-flag: set if the register contents are zero, cleared otherwise 
(the Z-flag is not modified by the TXS instruction). 

N-flag: set if the register contents were negative, cleared 
otherwise (the N-flag is not modified by the TXS 
instruction). 

C and V-flags: not modified by any of these instructions. 


3.*1.3 Increment and Decrement Instructions 

These instructions add ono or subtract one from either a memory 


location or a register. 


Name Description 


INC 

DEC 

INX 

DEX 

INY 

DEY 


Increment the contents of 
Decrement the contents of 
Increment the contents of 
implied addressing mode). 
Decrement the contents of 
implied addressing mode). 
Increment the contents of 
implied addressing mode). 
Decrement the contents of 
implied addressing mode). 


the target address by one. 
the target address by one. 
the X index register by one 

the Y index register by one 

the Y index register by one 

the Y index register by one 


(uses 

(uses 

(uses 

(uses 


The opcodes for each increment or decrement instruction with each of 
its possible addressing modes are as follows: 

[ ] (A) [Z] [ZX] [X] 


INC — EE £6 F6 FE 

DEC — CE C6 D6 DE 

INX E8 — 

DEX CA — — 

INY C8 — 

DEY 88 — 


Condition Codes: 


Z-flag: set if the result of the increment 
zero, cleared otherwise. 

N-flag: set if the result of the Increment 


or decrement 
or decrement 
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negative, cleared otherwise 

C and V-flags: not modified by any of these instructions 

3.Add and Subtract Instructions 

The 6502 has one addition instruction (ADC) and one subtraction 
instruction (SBC). The ADC instruction adds the contents of the 
target to the accumulator and then adds the value of the C-flag to the 
accumulator. The SBC instruction subtracts the contents of the target 
address from the accumulator and then subtracts the complement of the 
C-flag value from the accumulator. The C-flag is added to (or 
subtracted from) the accumulator to make it easy to perform arithmetic 
with multiple byte numbers. Whenever arithmetic is done with single 
byte numbers, the C-flag oust be cleared (set) before performing 
addition (subtraction). After the operation has been performed, the 
C-flag will be set if an addition resulted in a carry. The C-flag 
will be cleared if a subtraction resulted in borrow. Another ADC or 
SBC instruction can then be applied to the next more significant byte 
of a multi-byte number. 

Name Description 

ADC Add to the accumulator the contents of the specified byte 
plus the value of the C-flag. 

SBC Subtract from the accumulator the contents of the specified 
byte. Afterwards, decrement the contents of the accumulator 
by one If the C-flag was clear. 

The opcodes for the addition and subtraction instructions with each 
possible addressing mode are as follows: 

II) [A] IZ] [X)] [)Y] [ZX] [X] [Y] 


ADC 69 6D 65 6l 71 75 7D 79 

SBC E9 ED E5 El FI F5 FD F9 


Condition Codes: 

Z-flag: set if the final contents of the accumulator were zero, 
cleared otherwise (not set if decimal mode arithmetic is 
being used). 
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N-flag: 3et if the final contents of the accumulator were 
negative, cleared otherwise. 

C-flag: set if there was a carry in addition, cleared if not; 

cleared If there was a borrow in subtraction, set if 
not. 

V-flag: set if arithmetic overflow occurred, cleared if not. 


3-*1 • 5 Shift and Rotate Instructions 

These instructions move each bit in the selected byte (either a raenory 
location or the accumulator) one place to the left or right. The 
vacated bit position (bit 7 for a right shift, bit zero for a left 
shift) is filled either with a zero or with the previous value of the 
C-flag. In all cases, the bit that is bumped off the end is placed in 
the C-flag. 

Name Description 

ASL Arithmetic shift left. Shift all the bits in the targeted 

byte left one place, shift bit 7 into the C-flag, and shift a 
zero into bit zero. (This operation is equivalent to 
multiplying by two). 

LSR Logical shift right. Shift all bits in the targeted byte 

right one place, shift a zero into bit 7« and shift bit zero 
into the C-flag. 

ROL Rotate left. Shift all bits in the targeted byte one place 

to the left, shift the C-flag into bit zero, and shift bit 7 
into the C-flag. 

ROR Rotate right. Shift all bits in the targeted byte one place 

to the right, shift the C-flag into bit 7i and shift bit zero 
into the C-flag. (Note: if the C-flag is set to the same 
value as bit 7 before this instruction is executed, the 
result of the ROR will be to divide either a positive or 
negative number by two.) 


The opcodes for the shift and rotate instructions with each of the 
possible addressing modes are as follows: 

[A] fZ] [ZX] [X] Accumulator 


ASL 0E 
LSR HE 
KOL 2E 
ROR 6E 


06 16 

H6 56 

26 36 

66 76 


IE OA 

5E HA 

3E 2A 

7E 6A 


Condition Codes: 

Z-flag: sot If the result of the operation was 
otherwise, 


zero, cleared 
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N-flag: set if the result of the operation was a negative value, 
cleared otherwise. 

C-flag: set to the value of the bit that was "shifted out" of 
the byte being shifted. 

V-flag: not modified by any of these Instructions. 


3.4.6 Logical Operation Instructions 

These instructions perform a bit-by-bit logical operation between the 
bits of a specified byte and the bits of the accumulator, and leaves 
the result in the accumulator. A bit-by-bit operation means that each 
bit of the final accumulator value i3 a logical function of the same 
bit in the initial accumulator and in the specified byte. The 
instructions available and the logical functions they provide are 
listed below. 

Name Description 

AND Perform bit-by-bit "AND" of the accumulator with the selected 
byte and place the result in the accumulator. 

1 "AND" 1 = 1 
1 "AND" 0=0 
0 "AND” 1 = 0 
0 "AND" 0=0 

For example, A3 "AND" 8A = 82 

ORA Perform bit-by-bit "OR" of the accumulator with the selected 
byte and place the result in the accumulator 

1 "OR" 1 = 1 
1 "OR" 0 = 1 
0 "OR" 1 = 1 
0 "OR" 0=0 

For example, A3 "OR" 8A = AB 

E0R Perform bit-by-bit "E0R" ("exclusive OR") of the accumulator 
with the selected byte and place the result in the 
accumulator. 

1 "EOR" 1 = 0 
1 "EOR" 0 = 1 
0 "EOR" 1 = 1 
0 "EOR" 0=0 

For example, A3 "EOR" 8A = 29• (Note that "NOT" (that is, 
the logical operation that changes all zeros to ones and all 
ones to zeros) can be performed by performing an "EOR" 
operation on the accumulator with a value of FF.) 
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The opcodes for each logical instruction with each possible addressing 
node are as follows: 

[I] [A) [Z] [X)J t)Y] tZX] [X] [T] 


AMD 29 2D 25 21 31 35 3D 39 

ORA 09 OD 05 01 11 15 ID 19 

FOR *9 *»D 115 ill 51 55 5D 59 


Condition Codesi 

Z-flag: set if the final contents of the accumulator are zero, 
cleared otherwise. 

N-flag: set if the final contents of the accumulator are 
negative, cleared otherwise. 

C and V-flags: not modified by any of these instructions. 


3.il.7 Stack Instructions 

The basic stack operations performed by the 6502 are "push" and 
"pull". Push puts a new byte onto the stack, and "pull" removes the 
last byte pushed onto the 3tack. The stack pointer register always 
points to the address where the next byte will be pushed. 

The stack is used automatically when calling (JSR instruction) or 
returning from (RTS instruction) a subroutine. Therefore any bytes 
pushed onto the stack within a subroutine must be pulled from the 
stack before the return Instruction is executed. This is referred to 
as "keeping the stack balanced". 

Name Opcode Description 


PHA ilfl Push the contents of the accumulator onto the stack. 

PLA 68 Pull the next byte from the stack and put it into the 

accumulator. 

PHP 08 Push the contents of the processor status register 

onto the satok. 

PLP 28 Pull the next byte from the stack and place it into 

the processor status register. 


Condition Codes: 

PHA and PHP do not change any condition codes 

PLA changes the Z-flag and N-flag to indicate if the byte pulled 
from the stack was zero or negative. 

PLP loads a byte into the processor status register, and thu3, 
seta a value into each of the condition codes (as well 
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as setting the values for all the other flags). See 
Section 3.2.*l for the meaning of each bit in the 
processor status register. 

Besides the above instructions, the only other Instructions that 
affect the stack are JSR, RTS, BRK, and TXS. 


3.*1.0 Compare Instructions 

These Instructions are used to compare the contents of the accumulator 
with the value of another byte. After the compare operation has been 
performed, neither the contents of the register nor the value of the 
byte being compared will have been changed—the only thing changed 
will be the values of the 2, N, arid C-flags. These flags will be set 
as if the contents of the byte being compared had been subtracted from 
the register. 

The purpose of the compare instructions is to set up the 
condition codes for subsequent use with a conditional branch 
instruction. The three 6502 compare instructions are as follows; 

Name Description 


CMP Compare the contents of the accumulator with the specified 
byte and sot the condition codes accordingly. 

CPX Compare the contents of the X Index register with the 

specified byte and set the condition codes accordingly. 

CPY Compare the contents of the Y index register with the 

specified byte and set the condition codes accordingly. 


The opcodes for each compare instruction with each of its possible 

addressing modes are as follows: 

[I] [A] [Z] [X)] C m [ZX] [X] [Y] 

CMP C9 CD C5 Cl D1 D5 DD D9 

CPX E0 EC E*1 

CPY CO CC C*1 — 

Condition Codes: 

Same as SBC instruction except the V-flag is not altered. 
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3.*1.9 Branch Instructions 

The 6502 instruction set includes eight conditional branch 
Instructions. There are two instructions Tor each of the four 
condition code flags— one instruction to test if the flag was set, 
and one instruction to le3t if the flag was clear. If the test made 
is true, the program counter is reset to the address specified by the 
second byte of the instruction (using the "relative" addressing mode 
discussed in Section 3.3.12). If the test is false, the program 
counter is not changed and the instruction after the branch 
instruction is executed next. 

The conditional branch instructions are listed below: 

Name Opcode Description 


BMI 30 Branch if minus (i.e., branch if N-flag is set). 

BPL 10 Branch if plus (i.e., branch if N-flag is clear). 

BNE DO Branch if not equal to zero (i.e., branch If Z-flag 

is clear). 

BEQ F0 Branch if equal to zero (i.e., branch if Z-flag is 

set). 

BCC 90 Branch if C-flag is clear. 

DCS BO Branch if C-flag is set. 

BVC 50 Branch if V-flag is clear. 

BVS 70 Branch if V-flag is set. 


Condition codes: 

Not altered by any of these instructions. 

3.4.10 Jump Instruction 

This instruction forces the 6502 to reset the program counter to a new 
value and, thus, to continue program execution at a different address. 
This is the only instruction to use the "indirect" addressing mode. 
The opcodes for the Jump instruction are as follows: 

[A] [()] 

JMP 4C 6C 


Condition Codes: 




PACE J-20 


None of the condition codes are ohanged. 

3.14.II Subroutine Call and Return Instructions 

There are two 6502 instructions used with subroutines—one subroutine 
"call" instruction (JSR) and one subroutine return instruction (RTS). 
A subroutine is a series of Instructions that can be "called" from one 
or more places within a program. After the instructions in the 
subroutine have been executed, a "return" is made (i.e., the 
microprocessor continues program execution at the address following 
the subroutine call instruction). 

The subroutine calling instruction pushes the value of the 
program counter minus one onto the stack (the least significant byte 
is pushed first). This keeps a record on the stack of from what 
address the subroutine was called. When a return is made from a 
subroutine, a two byte address is removed from the stack, the address 
is incremented by one, and a Jump made to the resulting address. 
Program execution then proceeds starting with the first instruction 
after the call to the subroutine. 

One subroutine can call other subroutines (even itself !) as long 
as the stack does not overflow its allotted memory region. The stack 
can be used during a subroutine but it mu3t be restored to the entry 
configuration before the RTS Instruction is executed. 

In summary, the subroutine instructions are: 

Name Opcode Description 

JSR 20 Jump to subroutine. Push the current value of the 

program counter minus one onto the stack (least 
significant byte first), then Jump to the address of 
the subroutine. This Instruction uses absolute 
addressing mode to specify the address of the 
subroutine. 

RTS 60 Return from subroutine. Pull a two-byte absolute 

address from the stack, Increment the address by one, 
and Jump to the address. This instruction is one 
byte long and uses implied addressing. 
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Condition Codes: 

None of the condition codes are changed by these instructions. 


3.1J.12 Status Flag Manipulation Instructions 

These instructions set and clear flags in the processor status 


register. All of these Instructions use the Implied addressing mode. 

Name Opcode Description 

CLC 18 Clear C-Tlag 

SEC 38 Set C-flag 

CLD D8 Clear D-Tlag 

SED F8 Set D-flag 

CLI 58 Clear I-flag 

SEI 78 Set I-riag 

CLV B8 Clear V-flag 


Condition Codes: 

None of these Instructions alter any of the conditions except 
for those flags mentioned in the instruction's 
description. 

Note: The V-flag can be set with the BIT Instruction. 


3.*.13 NOP instruction 

NOP is a single byte instruction (with opcode EA) that does nothing. 
It is useful for waiting for a while (a few microseconds) or to 
reserve space in a program for instructions that you may want to 
insert later. Similarly, if an instruction needs to be removed, you 
can replace each of its bytes with NOP instructions to avoid having to 
move other instructions to close the gap. 


3.H.1* Bit Test Instruction 

The bit test instruction (BIT) performs a bit-by-bit "AND” of the 
accumulator with a specified byte (See description of the AND 
instruction for a description of a "bit-by-bit AND".). The results of 
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this AND Is only used to set the condition codes, the contents of the 
accumulator as well as the value of the specified byte are not 
changed. Like the compare Instructions, the BIT Instruction is 
usually followed by a conditional branch Instruction. The opcodes for 
the BIT instruction with each of Its possible addressing modes are as 
follows: 

[A3 [Z] 

BIT 2C 2*» 

Condition Codes: 

Z-flag: set If the result of the bit-by-bit AND is zero, cleared 
otherwise. 

N-flag: set to the value of bit 7 of the byte being ANDed with 
the accumulator. 

V-flag: set to the value of bit 6 of the byte being ANDed with 
the accumulator. 

C-flag: not changed by this Instruction. 

3.^.15 Break Instruction 

The break instruction (BRK) is the only part of the Interrupt 
capability of the 6502 available to MaglCard users. Execution of the 
BRK Instruction (opcode 00) performs a reset of the MaglCard similar 
to that caused by turning the power off and on again. BRK has the 
following advantages over turning the power off: 

1. A reset can be initiated under program control. 

2. The contents of the program storage memory (F000 - F3FF) are 
not lost. 

A programming mistake will often lead to the execution of a BRK. For 
example, If a Jump is made to an Improper location, the 6502 will 
start to execute some random values as If It were a program. In such 
cases it Is reasonably likely that it will soon encounter a byte 
containing a zero, and therefore, reset itself via a BRK. A complete 
description of the reset that occurs when a BRK is executed (or when 
the MaglCard la first powered up) will be found in Section 7.16* 1 * 




CHAPTER 4 


MaglCard Keyboard Functions 

In this chapter we discuss in detail the Function of each 
keyboard controller key when the MaglCard is plugged into your Atari 
game. The keys on the keyboard controllers are referred to by a 
letter "L" or "R" ("L" for the left controller, "R" for the right 
controller) followed by a symbol for the key on the controller 
The function naac3 correspond to the names on the 
cut-out keyboard overlays. 

Each key on the left controller has two distinct functions 
(referred to as "unshifted" and "shifted"). Pressing the RO key 
(right controller zero) key causes all the keys on the left controller 
to take on their shifted functions. Shifted mode is exitted by 
pressing the LO key. The right controller keys have no function in 
shift mode. The shifted functions for each left controller key are 

printed on the keyboard overlay above the unshifted function. 

The first section in the chapter gives a brief description of the 

function of each controller key. Each subsequent section is devoted 

to describing one particular key function in more detail. 
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*1.1 Brief Description of Key Functions 


<3.1.1 Left Controller Functions (Unshifted) 


Key Name Function 

LI I Enter hex digit "1" into the right most character of the 

display's top line. 

L2 2 Enter hex digit "2" into the right most character of the 

display's top line. 

L3 3 Enter hex digit "3" into the right most character of the 

display's top line. 

LH U Enter hex digit "H" into the right most character of the 

display's top line. 

L5 5 Enter hex digit "5" into the right most character of the 

display's top line. 

L6 6 Enter hex digit "6" into the right most character of the 

display's top line. 

L7 7 Enter hex digit "7" into the right most character of the 

display's top line. 

L8 8 Enter hex digit "8" into the right most character of the 

display's top line. 

L9 9 Enter hex digit "9" into the right most character of the 

display's top line. 

LO 0 Enter hex digit "0" into the right most character of the 

display's top line. 

L 1 Fetch Read the contents of the memory location whose address is 
in the "Fetch Address" (see description of R B key) and 
place into the right two hex digits of the display's top 
line, shift the previous right two display digits two 
digits to the left, and increment the "Fetch Address" by 
one. 

Write the contents of the right two digits on the 
display's top line into the memory location whose address 
is in the "Store Address" (see description of HO key) and 
Increment the "Store Address" by one. 


L# Store 
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4.1.2 Right Controller Functions (Unshifted) 


Key Name Function 

R1 A Enter hex digit "A" into the right most character of the 

display's top line. 

R2 B Enter hex digit "B" into the right most character of the 

display's top line. 

R3 C Enter hex digit "C" into the right mo3t character of the 

display's top line. 

R4 D Enter hex digit "D" into the right most character of the 

display's top line. 

R5 E Enter hex digit "E" into the right most character of the 

display's top line. 

R6 F Enter hex digit n F" into the right most character of the 

display's top line. 

R7 Cend Ad Enter the right four hex digits on the display's top line 
into "Cend Address". "Cend Address" is used when writing 
data to or reading data from a cassette. 

Rfl Relc Calculate relative offset for branch instructions. As 

discussed in Section 3*3«9» the second byte of each 
branch instruction contains a signed two's-complcmcnt 
number that specifies the number of bytes between the 
address following the branch instruction and the address 
to be branched to. Thi3 byte i3 called the "relative 
offset" of the branch. You can use the MagiCard to 
determine the value to use for the relative offset by 
proceeding as follows. First, place the absolute address 
(four hex digits) of the second byte of the branch 
instruction into "Store Address". Next, enter the 

absolute address of the destination of the branch into 
the right four digits on the display's top line. Pushing 
the R8 key then calculates the two hex digit branch 
offset that should be stored in the second byte of the 
branch instruction. A result of FF implies that the 
branch is out of range. The previous contents of the 
right four digits on the display's top line are moved 
into the left four digits. 

R9 Extra Ad Enter the right four hex digits on the the display's top 
line into "Extra Address". The current value of "Store 
Address" la also placed into the left four digits of the 
display's top line. "Extra Address" is not used by the 
MagiCard Monitor; however, it can be useful to pass 
information to a user program. 

RO Shift Shift lock. Pressing this key causes each key on the 
left controller to assume its "shifted" function. The 
left controler remains "shifted" until the LO ("unahirt") 
key is pressed. All keys on the right controller have no 
"shifted" function. Pressing the "Game Reset" on the 
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Video Computer console will also "unshift" the keys. 

H" Fetch Ad Enter the right four hex digits on the display's top line 
into "Fetch Address". The current value of "Cend 
Address" is also placed into the loft four digits of the 
display's top line. 

R# Store Ad Enter the right four hex digits on the display's top line 
into "Store Address". The current value of "Extra 
Address” is also placed into the left four digits of the 
display's top line. 


*1.1.3 Left Controller Functions (Shifted) 

These functions are performed by the left controller keys when it has 
been "shifted" by pressing the RO key. The functions performed by 
keys LI through L6 are specially protected to avoid accidental 
activation. When one of these keys is pressed, the TV screen will go 
blank. If at this point the "Game Select" switch on the Video 
Computer console is pressed, the selected function will be executed. 
If, on the other hand, the "Came Reset" switch on the Video Computer 
console is pressed, the MaglCard will not perform the selected 
function but will Instead perform its power-up initialization 


sequence. 
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Key Name Function 

Li Run Start program execution at the address contained in 

"Store Address". (Waits for "Game Select" with screen 
blank.) 

L2 No operation (Waits for "Game Select" with screen blank.) 

L3 No operation (Waits for "Game Select" with screen blank.) 

HI Cwrite Cassette write. Write to cassette the contents or memory 

addre33es "Fetch Address" to "Cend Address" -1. See 
Section *1.6 for details about cassette operations. 
(Waits for "Game Select" with screen blank.) 

L5 No operation (Waits for "Game Select" with screen blank.) 

L6 Cread Cassette read. Read data from cassette and store into 

memory addresses "Fetch Address" through "Cend 
Address" -1. See section *1.7 for details about cassette 
operations. (Walts for "Game Select" with screen blank.) 

L7 Hex Dump Hexadecimal dump. Display on the screen (as four hex 
digits) the contents of two bytes of memory starting at 
the address contained In "Fetch Address". "Fetch 
Address" is then incremented by two. 

L8 Ins Dump Instruction Dump. Display on the screen the disassembled 
form of the Instruction starting at the address contained 
In "Fetch Address". "Fetch Address" i3 then incremented 
by the length of the instruction. 

L9 No operation 

LO Unshift "Unshift" the left controller keys. The left controller 
keys return to their normal "unshifted" functions. 

L* No operation 


No operation 
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4.2 Hex Dump Function (Shift L7) — Further Information 

After pressing the HO (Shift) key, each time the L7 (Hex Dump) key is 
pressed the entire display is moved up one line (scrolled one line) 
and a new line is added at the bottom. The new line contains three 
pieces of information (or "fields"). The first field is four 

characters in length and displays the "Fetch Address" value as a hex 
number. The second field is two characters in length and displays the 
hex number contained in the location at that address. The third field 
is also two characters in length and displays the hex number contained 

in the next location. After the new line is displayed, the contents 

of "Fetch Address" is incremented by two so the next time the L7 key 
is pressed the contents of the next two memory locations will be 

displayed. 

4.3 Instruction Dump Function (Shift L8) — Further Information 

After pressing the RO (Shift) key, each time the L8 key is pressed, 

the entire display is scrolled two lines up and two new lines are 

added at the bottom. These two new lines describe the Instruction 

contained at address "Fetch Address". The upper new line contains the 

four digit hex address of the instruction being dumped. The next line 
contains three fields—the instruction name field, the instruction 
addressing mode field, and the address information field. 

The Instruction name field occupies the first three characters. 
This field contains the three character opcode name (see Section 3.4) 
for the Instruction being dumped (i.e., the instruction starting at 
address "Fetch Address"). If the byte at the address "Fetch Address" 
is not a legal opcode, the Instruction name "ILL" is displayed and the 
rest of the line is blank. 

The addressing mode field occupies the next two characters. This 
field contains the two character addressing mode name for the 
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instruction (see Section 3.3). For relative addressing, this field 
will contain the two hex digits of the instruction (which is the 
relative address itself). 


NOTE 

Due to an Irregularity in the 6502 
instruction set, the addressing mode of 
the "JSR" instruction will always be 
listed as [Y] rather than the correct 
value of [A]. Just ignore this error 
and remember that JSR (opcode 20) has an 
addressing mode of [A]. 

The additional addressing information field occupies the last 
four characters. For instructions with accumulator or implied 
addressing (l.e., an addressing mode field of [ ]), this field will be 
blank. For two byte instructions (with the exception of branch 
instructions), this field will contain the second byte of the 
instruction. For three byte instructions, this field will contain the 
four hex digit address contained in the last two bytes of the 
instruction. The most significant byte of the address is placed in 
the first two hex digits (for easy reading); even though they are 
stored in the opposite order in memory. For branch instructions, this 
field will contain the absolute address to which the instruction would 
branch. Hence, you can see both the relative address (in the 
addressing mode field) and the corresponding absolute address (In the 
additional address information field). 

After the instruction information is displayed on the bottom two 
lines, "Fetch Address" is incremented by the length or the instruction 
(Instructions with illegal opcodes are considered to hove a length of 
one byte). Note that attempting to dump arbitrary data as 
instructions may be misleading because any random one byte number has 
about a 60% chance of being a legal opcode. Similarly, if you begin 
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to dump at an address that corresponds to the second or third byte of 
a multiple byte instruction, that byte may be interpreted as a legal 
Instruction opcode. Depending on the particular case, several 
spurious instructions may be dumped (some of them "ILL") before, by 
chance, the first byte of a real instruction is encountered. From 
that point on, dumping will proceed normally. 

The same sort of trouble may occur if you are dumping a program 
that you have incorrectly entered into memory. A mistyped opcode to a 
multiple byte instruction may give rise to a confused dump immediately 
following the error. In this case, you should correct the erroneous 
opcode and dump again. These cases may sound confusing, but once you 
are aware of the possibility of their occurrence, they are easy to 
recognize in practice. 

*l.*1 Combined Use of Fetch (L B ) and Store (L#) Keys 

The "Fetch" key places the byte whose address is "Fetch Address" into 
the right two hex digits of the display's top line. Similarly, the 
"Store" key stores the right two hex digits of the display's top line 
into the address "Store Address". By setting "Fetch Address" and 
"Store Address" to the same value, and then alternately pushing 
"Fetch" and "Store", you can move through memory while watching the 
bytes move through the right two characters on the display's top line. 

It is also possible to make changes to memory as the bytes are 
displayed. After a byte has been placed into the right two hex digits 
of the display by pressing the "Fetch" key, a new value may be keyed 
into the display (by pressing the keys LO through L9 or R1 through R6) 
before the "Store" key is pressed. When "Store" is pressed, the old 
value for the byte will be overwritten by the new value. 

If the "Fetch Address" and "Store Address" are set to different 
values, an identical procedure will move data from one place in memory 
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to another (with optional modification to any byte de3ired). It is 
helpful to understand that the above procedures are simply 
combinations of the simple functions of "Fetch" and "Store". 

*1.5 Relc Function (R8) — Further Information 

It is often convenient to write a program using names for the 
addresses that arc the destinations of branch, JMP, or JSR 
Instructions. Once the program has been written, the value of each 
address name can be determined by choosing a starting address for the 
program and counting the number of bytes in all the instructions 
between the starting address and each address name. For any 
instruction that uses absolute addressing (e.g. f JMP or JSR), the 
absolute address itself is placed In the second and third bytes of the 
instruction. In the case of branch instructions, however, the 
absolute address itself is not lnoluded in the instruction. What is 
needed is a two's complement byte offset between the address of the 
memory location Immediately after the branch instruction and the 
address of the branch destination. For branches to nearby locations, 
the offset calculation becomes easier with practioc. Branches to 
distant parts of the program arc not so easily handled. 

The "Relc" function can save time in determining the offset to 
use for branch instructions (read its description In Section *1.1.2 if 
you have not already done so). When you are entering a branch 
instruction as part of a program, first key in and store in memory the 
opcode byte for the branch. Then, Instead of the two digit byte 
offset that goes into the second byte of the branch instruction, key 
in the absolute address to which the branch is intended to go and 
press the R8 ("Relc") key. If the new value in the right two 
characters of the display la not FF, it is the correct relative offset 
for the branch instruction. You only need to press the "Store" key to 



place the offset Into memory and can then continue keying In the next 
instruction of the program. 

4.6 Cassette Write Function (Shift L4) — Further Information 

The "shifted" function of the L4 key writes a range or memory 
locations to a cassette tape. The series of operations required are 
as follows: 

1. Enter the address or the first byte to be saved on cassette 
into "Fetch Address" (using the R f key). 

2. Enter the address Immediately following the last byte to be 
saved Into "Cend Address" (using the R7 key). 

3. Press "Shift Lock" (RO), then "Cwrite" (L4). (The display 
will go blank.) 

4. Flip the cassette interface switch on. 

5. Start the cassette recorder in record mode (Volume half way 
up, tone on "high"). 

6. Press the "Come Select" switch on the Video Computer console 
(If you are writing at the beginning of the cassette, wait 
until the leader is passed before pressing "Game Select"). 

7. When the display reappears, wait a few seconds and stop the 
recorder. 

8. Flip the cassette interface switch off. 

9. Press the "Unshift" key (LO). 

Writing data to a cassette produces a 12 second high-pitched header 
tone followed by a high warble tone that represents the data. The 
data tone is followed by a loud, low buzz tone. Each byte written to 
cassette has an associated parity bit (even parity) which is checked 
when the byte is read back ("Cread" function). Details of the setup 
and connection of the cassette are included along with construction 
notes in Appendix E. 

4.7 Cassette Read Function (Shift L6) — Further Information 

The "shifted" function of the L6 key reads data from a cassette tape 
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into a range of memory locations. The series of operations required 
are as follows: 

1. Enter the address of the first memory location to receive 
data from cassette into "Fetch Address" (using the R # key). 

2. Enter the address of the memory location immediately 
following the area to receive data into "Cend Address" (using 
the R7 key). 

3. Press the "Shift" key (RO), then the "Cread" key (L6). (The 
display will go blank.) 

U. Flip the cassette interface switch on. 

5. Start the cassette in playback mode (Volume halfway up, tone 
"high") with the tape positioned within the high-pitched 
"header". 

6. Press the "Game Select" switch on the Video Computer console 
(while the recorder is still playing back the header tone). 

7. When the display reappears, atop the recorder. 

8. Flip the cassette interface switch off. 

9. Press the "Unshift" key (LO). 

10. Press the LO key four times and then press the "Cend Ad" key 
<R7). 

After all these steps are done, the left four characters on the 
display's top line will show the address of the location Immediately 
after the last memory location that was filled with cassette data. 
This should equal the value placed into "Cend Address" in Step 2. If 
it does not, bad data was encountered (a parity error) at about the 
address shown and the cassette input stopped. Try rereading, perhaps 
with the volume turned up a bit (the tone control should be as high as 
possible). 

If the display doesn't return after the recorder has read through 
the data, either the recorder volume was too low, a cable was 
disconnected, or an improper address was entered in Step 1 or Step 2. 
The simplest way to recover is to briefly turn off the power to the 
Video Computer System. If that is not desirable, playing the cassette 
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through any random data while adjusting the volume will usually cause 
recovery of the display (due to an input parity error). 

Notice that data can be read back into memory at any address 
entered in Step 1—not necessarily the same place It resided when It 
was recorded. Similarly, less than the full amount of data can be 
read back from a tape (though you must always start at the beginning). 
For example, a gap can be created in the middle of a program to add 
new instructions. To produce the gap, first read the entire program 
into memory but store it at an address that 13 larger than the 
original starting address by the size of the desired gap. Next, read 
the program in again storing It at the normal starting address but 
ending at the instruction Just before the gap. This leaves a region 
of duplicated instructions in the middle of the program that can be 
overwritten by keying in new Instructions. It is also possible to 
delete instructions from the middle of a program by reading the entire 
program Into a lower address than usual and then overwriting the 
beginning by reading in a portion of the program at the normal 
address. 

Code moved in this way may require a few modifications (i.e., to 
addresses contained within its instructions or to another portion of 
the program that references the moved portion), but for a large 
program of hundreds of instructions this can be far easier than 
reentering the entire program. Tou may even develop a few subroutines 
that are used frequently in different programs. If you write them 
using a carefully chosen subset of the 6502 instruction set and 
addressing modes, you will be able to place them anywhere in memory 
(using the cassette if they are long) and use them without 
modifications. A subroutine having this property is said to be 
"position independent”. 
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MagiCard Memory Map 

In this chapter we define the MagiCard memory map--that is, what 
each possible two-byte absolute address is U3ed for. As you will sec, 
some addresses are used to refer to memory locations (such as the 
memory that your programs can be stored in) while other addresses are 
used to control the audio and video capabilities of your Atari Video 
Computer System. In the next section, we give a broad outline of the 
use of each range of addresses. In the remaining sections of this 
chapter we provide more details of the use of those addresses that 
reference actual memory. A description of the audio and video control 
features is given In Chapter 6. 
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5.1 Basic Memory Map 
Address Range Contents 


0000 - 003F Control registers Tor the TV display, sound and part of 
the game controllers. This range of addresses controls 
all of the video and audio features of your Video 
Computer System; therefore it is called the "Display 
Generator". 

0040 - 007F The same as 0000 - 003F (i.e. a reference to location 
0040 is identical to a reference to location 0000; a 
reference to 0041 is identical to a reference to 0001 
etc.). 

0080 - 00FF Read/Write memory (RAM) used for the stack, temporary 
storage of calculations, etc. This range of memory 
locations is called "Zero Page RAM". The MagiCard 
Monitor uses locations 0080 - 00A9 (as temporary 
variables) and 0OF9 - OOFF (for the stack) so use of 
these locations by a U3er program should be avoided. 

0100 - 01FF Same as 0000 - OOFF 

0200 - 02FF Control registers for the 6532 multifunction device. 

This device is described in Section 6.1. 

0300 - EFFF This addre^3 range serves no useful function but no 

reference should he made to these addresses as it may 
cause unpredictable results for your program I! 

F000 - F3FF Program storage read/write memory (RAM). Locations 

F000 - F0D1 are used to store the pixel-bits used by 
the TV display generating subroutine (see Seotlon 7.1). 
User written programs can occupy locations F0D2 - F3FF. 
This entire memory range (F000 - F3FF) can be freely 
read by a user program but any attempt to modify one of 
these locations must occur via one of the monitor 
subroutines (see Section 5.2). 

F400 - F7FF Used by the MagiCard Monitor program to 3tore values 

into the RAM contained in F000 - F3FF (see 
Section 5.2). 

F800 - FFFF Contains read only memory (ROM) which holds the 

MagiCard Monitor program and its user callable 
subroutines. This memory can be read by the user 
program but cannot be written Into. 




MagiCard Memory Map 


PAGE 5-3 


5.2 Details on Use or Address F000 - F7FF 

As mentioned above, the address range F000 - F3FF contains memory that 
can be used for user written programs and user data. However there 
are important restrictions on how this memory can be used. The 
restrictions are as follows: 


1. Mo instructions that store into memory can reference an 
address In the range F000 - F30Q (These addresses are 
"read only"). An example of a store Instruction is "STA". 

2. An instruction that stores a value Into an address In the 
range F400 - F7FF will actually place the value Into an 
address 400 lower In memory. For example, a store to 
location F523 places the value Into F123. (The addresses 
F400 - F7FF are "write only"). 

3. None of the following Instructions can be used with any 
addresses In the range FOOO - F7FF : ASL, DEC, INC, LSR, 
ROL, ROR. The reason for this Is that these Instructions 
read a value from a location, modify it, and store it back to 
the 3ame location. Since addresses Trom FOOO - F7FF contains 
either read only or write only memory, it is impossible to 
read from and then write back into memory using the same 
address for both operations. 

4. Instructions that store to the address range F400 - F7FF must 
be located In the MagiCar d Monitor ROM or the zero page RAM 
(80 - FF) . Any other attempt to store into these locations 
may work with some MagiCard modules but its reliability 
cannot be guaranteed . User programs that wish to store into 
locations F400 - F7FF can either do so from the zero page RAM 
(perhaps by placing a small subroutine there) or they can 
make use of the monitor subroutines that store Into this 
address range (In particular, see the STPM subroutine 
described in Section 7.2). 

Additional Restriction : When using indexed addressing 
modes to store into this address range, the most sig¬ 
nificant byte of the address provided by the instruc¬ 
tion must not change when the index is added. 

5.3 Use of Zero Page RAM (0080 - 00FF) by MagiCard Monitor 

In this section we give a brief description of how the zero page RAM 

is used by the MagiCard monitor program. The four letter names for 

subroutines (such as PSHD and DSPL) used below arc the same ones used 

In Chapter 7 where the monitor subroutines are described. The symbols 

"USB" and "MSB" mean "least significant byte" and "moat significant 


byte' 


ipectlvely. 



Address Use 


80,81 LSB,MSB of keyed in digits accumulated by subroutine PSHD. 

82,83 Left,Right keyboard controller number of new key pressed 

(filled by subroutine DSPL). 

8*1,85 LSB.MSB of "Store Address" (filled by the monitor when the Rtf 
key is pressed). 

86,87 LSB,MSB of "Fetch Address" (filled by the monitor when the R f 
key is pressed). 

88,89 LSB,MSB of "Extra Address" (filled by the monitor when the R9 
key is pressed). 

8A,8B Left,Right keyboard controller number of current key pressed 

(filled by subroutine DSPL). 

8C,8D LSB,HSB of "Cend Address" (filled by the monitor when the R7 
key Is pressed). Also used as the base address for 
subroutine STPM. 

8E Character number used as input for subroutine ONEC. 

Also horizontal position Input parameter for subroutine CALP. 

8F Line number used as Input for subroutines ONEC and DOLN. 

Also vertical position input parameter for subroutine CALP. 

90 Used by CRED/CWRT to hold the byte currently being 
read from/wrltten to cassette. Used as a temporary storage 
location by ONEC, DOLN, CALP and DTSA. 

91 Used by CRED to hold the LSB of the address where the next 

byte read from the cassette is to be stored. Used as a 

temporary storage looatlon by ONEC, DOLN, and MAIN. 

92 Used by CRED to hold the MSB of the address where the next 

byte read from the cassette is to be stored. Used as a 

temporary storage location by ONEC, DOLN, and MAIN. 

93 - 97 Used by subroutines ONEC and DOLN. 

93 Used by ADTY and INSN to save the X index register. Used by 

CRED and CWRT in performing parity checks. 

9^,95 Used by GO (see Section 7.15.7) to store the LSH,MSB of the 
address to which it Jumps. 

96 Cursor blink counter used by MAIN. 

98 - A1 ASCII character codes input to ONEC and DOLN. 

A2 - A9 Zeroed by RSET (when a BRK instruction is executed or when 

the Video Computer System is powered up) but not otherwise 
used by the monitor. 

A9 - F8 Totally untouched and unused by the KaglCard monitor. Can be 
used by a user program for anything it wishes. 
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F9 - FP Used as the stack by the monitor and monitor subroutines. 

When execution of a user program is begun (by pushing the 
"Run" key), the stack pointer register will contain FF. 
Monitor subroutines are guaranteed not to push more than 
seven bytes onto the stack, thus using locations FF through 
F9. If the user program uses the stack and then calls a 
monitor subroutine, the stack may extend below location F9. 
Be very cautious to avoid placing a program in locations that 
may get overwritten by the stack (or vice-versa). 



CHAPTER 6 


Details of Video Computer System Features 

The Atari Video Computer System is capable of performing many 
sophisticated tasks as you can Immediately see by playing an Atari 
game cartridge. The MagiCard monitor provides subroutines that allow 
easy access to a very useful subset of the Atari features. In order 
to fully realize the potential capabilities, however, a much deeper 
understanding of how the Video Computer System works is required. 

In this chapter a great deal of information about the operation 
of the Video Computer System is given. For some features (such as the 
"high resolution" graphics capability), a complete description is 
beyond the scope of this manual. However, you will find enough of an 
explanation to give you a good start in Investigating these features 
yourself (either by using the MagiCard monitor keyboard to store 
values into the control registers, or by writing some test programs). 

The first three sections of this chapter each discuss one of the 
devices that are used to provide the Video Computer System features. 
These devices are the 6532 multifunction integrated circuit, the game 
controllers (keyboard, paddle, and Joystick) and switches, and the 
Atari display generator Integrated circuit. The last two sections 
give more dotails on the 3ound generating feature and on how to keep 
the display synchronized on your TV set. 
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6.1 The 6532 Multifunction Integrated Circuit 

The 6532 multifunction integrated circuit (called the "RIOT") is a 
chip in the 6502 family of integrated circuits. It is manufactured by 
the same companies that make the 6502 (Rockwell International and MOS 
Technology). The name "RIOT" stands for RAM-Input-Output-Timer, 
because the RIOT does all these things. Related chips In the 6502 
family (such as the 6522 PIA and especially the 6530 RRIOT) are 
similar enough to the RIOT that you can learn a great deal by reading 
any information you may be able to find about them. In this section 
the RIOT is described, slighting its Interrupt capabilities, because 
interrupts are not used by the Video Computer System. The details of 
how the RIOT is connected to the Atari controllers is given in 
Section 6.2. 


6.1.1 Input/Output (I/O) Ports 

The RIOT has two input/output ports, labeled "A" and "B". Each I/O 
port ba3 eight lines that can either input (read) or output (write) 
TTL logic signals (i.e. from 0 to 5 volts). Each port also has two 
eight-bit registers: a "data direction register" and a "data value 
register". The n'th bit in these registers is associated with the 
n'th line in the port. The data direction register is used to specify 
the mode (input or output) for each line. A bit value of one sets the 
corresponding line to output, a value of zero sets it to input. Once 
the data direction register has been set, the data Itself is road from 
(or written to) the data value register. When using a port for 
output, a bit set to one in the data value register produces an output 
signal of TTL "high" (2.4 to 5-0 volts). A bit set to zero produces 
an output signal of TTL "low" (0.0 to 0.4 volts). Each output line 
can drive one TTL load plus 30 pf of capacitance. When using a port 



Details of Video Computer System Features 


PAGE 6-3 


for Input, a TTL high signal or an unconnected line produces an input 
bit of one, and a TTL low signal produces an input bit of zero. 

On power up, the RIOT data direction registers are set to zero 
(Input). All eight bits of the A port are set to output when the DSPL 
subroutine is called (and by the monitor program Itself beoause it 
calls DSPL). The B port is left In the input node by the monitor 
program and is also reset to input when a BRK instruction is executed. 

The A and B I/O ports are very similar in their operation, with 
the following execeptlons: 


1. When used for output, I/O port B can supply more current at 
loglo state zero than port A (Both ports can supply 1.6 ma at 
0.4 volts. Port B can supply 3.0 ma at 1.5 volts). 

2. If a line in the B port is set to output, the value of its 

bit in the data value register will always be the last value 

the bit was set to. A read of a bit in the A port data value 

register will, under the same circumstances, return the logic 
value that actually exists on the output line. Thus, if the 
A port's smaller drive capacity is overridden by an incoming 
signal, the incoming signal can be detected. Reading the 

data direction register of either port always returns the 
last value written into it (00 immediately after power up). 

3. The most significant bit (bit seven) of the A port has the 

capability of detecting logic transitions and seting another 
bit in a RIOT control register when a transition has 

occurred. It is possible to detect transitions from 
logic zero to logic one, logic one to logic zero, both, or 
neither. 


6.1.2 RAM 

The RAM contained in the RIOT is Just the zero page RAM with memory 
addresses 80 through FF. 


6.1.3 Timer 

The RIOT has a single count-down timer. A somewhat simplified 
description of its operation is given. (The timer in your Video 
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Computer System may not do exactly what the 6532 data sheet says, but 
It will do what Is described here.) Basically the timer Is a register 
whose value can be set, and which will then automatically decrement at 
some fraction of the microprocessor clock rate. By using RIOT control 
registers you can: 

1# Set the timer to a value and begin Its countdown. 

2. Set the rate of countdown as a fraction of the microprocessor 
clock rate (1.197MHz). 

3. Read the current timer value. 

>1. Check if the countdown has reached zero. 

When the countdown reaches zero, the timer sets the timer-count-down 
flag, waits as long as it did at any other timer value during the 
countdown, sets the timer value to FF, and begins a repeated count 
down from FF to 00 at the full microprocessor clock rate. 


NOTE 

The microprocessor clock counts 76 times 
in 1/15,750 of a second. 1/15,750 of a 
second is the time needed for a TV set 
to scan one horizontal line of the 
picture. This fact is important when 
you are trying to synchronize a display 
on the TV screen (see seotlon 6.5)• 


6.1JI RIOT Control Registers 

In this section the addresses and functions of the RIOT control 
registers are described. These registers are memory locations that 
perform a special function when they are written into or read from. 
Many of the registers serve a dual function—when they are written 
into they may 3et a value for ono of the RIOT functions, and when they 
are read from they may give a value that is associated with a 
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different RIOT function. The RIOT cannot interrupt the 6502 
microprocessor, but the the interrupt-status flags (in location 0285) 
will be set whenever an interrupt-causing condition has occurred. 
When using the table below, remember that the bits In a byte arc 
numbered from zero (the least significant bit) through seven (the most 
significant or sign) bit. 
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Address (Read/Write) Function 


0280 (R/W) I/O port A data value register. When a line that 

has been set to output is read, the value seen is 
the actual logic value on the lino not the value 
that was last written into this register for that 
line. 

0281 (R/W) I/O port A data direction register. (A bit value 

of zero 3ets a line for input.) 

0282 (R/W) I/O port B data value register. When a line that 

has been set to output is read, the value seen is 
the value last written into this register for 
that line. 

0283 (R/W) 1/0 port B data direction register. (A bit value 

of zero sets a line for input). 

0284 (R) Current timer contents. This value is always 

being counted down. 

0294 (R) Same as 0284 except reading this location 

disables netting of the tioer-eount-down flag 
when the timer has counted down to zero. 

029C (R) Same as 0284 except reading this location enables 

setting of the timer-count-down flag when the 
timer has counted down to zero. 

0285 (R) Read and reset flag bits 

Bit seven is the timer-count-down flag (set to 
one when the timer reaches zero). 

Bit six is the bit-seven-transition flag. This 
bit can be used (assuming that things have 
been properly set up by writing into location 
0284 or 0285) to detect logic transitions on 
the most significant line of the A 1/0 port. 

Bits zero through five will always be read as 
zero. 

0295 (R) Same as 0285 except reading this location 

disables setting of the timer-count-down flag 
when the timer has counted down to zero. 

029D (R) Same as 0285 except reading this location enables 

setting of the timer-count-down flag when the 
timer has counted down to zero. 

0284 (W) Enable setting of bit-seven-transition flag when 

line seven on the A I/O port goes from logic 

state one to logic state zero. 

0285 (W) Enable setting of bit-seven-transition flag when 

line seven on the A I/O port goes from logic 

state zero to logic state ono. 
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0286 (W) Disable setting of bit-seven-flag for a logic one 

to logic zero transition. 

0287 (W) Disable setting or bit-seven-flag for a logic 

zero to logic one transition. 

(It does not matter what value la written into 
locations 0284 through 0287.) 

029*1 <W) Set timer count down value, begin counting down 

every microprocessor clock cycle, and disable 
setting of timer-count-down flag. 

0295 (W) Set timer count down value, begin counting down 

every eighth microprocessor clock cycle, and 
disable setting of tloor-count-down flag. 

0296 (W) Set timer count down value, begin counting down 

every sixty-fourth microprocessor clock cycle, 
and disable setting of timer-count-down flag. 

0297 (W) Set timer count down value, begin counting down 

every 1024-th (decimal) microprocessor clock 
cycle, and disable setting of tloer-eount-down 
flag. 

029C (W) Same as location 0294 except enable setting of 

timer-count-down flag. 

029D (W) Same as location 0295 except enable setting of 

timer-count-down flag. 

029C (W) Same as location 0296 exepet enable setting of 

timer-count-down flag. 

029F (W) Same as location 0297 except enable setting of 

timer-count-down flag. 
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6.2 Game Controller and Switch Connections 

In this section we discuss how the Atari game controllers (keyboard, 
joystick, and paddle) are interfaced to the microprocessor. The two 
controllers are connected to the Video Computer System via two nine 
pin connectors. When viewed from the back of the game, the pins on 
the connectors are numbered as follows: 


right controller left controller 



Figure 10 


The following abbreviations will be used in describing how the game 
controllers are connected: 

LCn s Pin number "n" on loft controller connector (n runs from 
one to ni ne), 

RCn = Pin number "n" on right controller connector (n runs from 
one to nine). 

PAn = RIOT I/O port A line number "n" (n runs from zero to 

seven). 

PBn « RIOT I/O port B line number "n" (n runs from zero to 

seven). 

6.2.1 Rear Connector Wiring 

The two rear connectors are wired inside the game as follows: 

Pin Connected to 

RC1 PAO 

RC2 PA1 

RC3 PA2 

RCU PA3 

RC5 Display Generator control register at location 3A 
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RC6 Display Generator control register at location 3D 

RC7 ♦5 Volts (note that the game is not capable of supplying 

more than 10 mA of current) 

RC8 Power ground 

RC9 Display Generator control register at location 3B 

LC1 PA4 

LC2 PA5 

LC3 PA6 

LC4 PA7 

LC5 Display Generator control register at location 38 

LC6 Display Generator control register at location 3C 

LC7 *5 Volts (note that the game is not capable of supplying 

more than 10 mA of current) 

LC8 Power ground 

LC9 Display Generator control register at location 39 

Rear connector pins RC5, RC6, RC9, LC5 t LC6, and LC9 are each 
"connected to" a register in the Atari display generator (see 
Section 6.3). A program can read the display generator register to 
determine the voltage that is applied to the rear connector pin 

associated with the register. If the pin is grounded, a positive 

value will be read; if the pin is connected to *5 volts or left 
floating, a negative value will be read. It takes a couple of hundred 
microseconds for a change in voltage at a connector pin to be 
reflected in the value read from a control register. Rear connector 
pins LC6 and RC6 are electrically connected in a slightly different 
way than th6 other connector pins. 
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6.2.2 Console Switches Connections 

The switches on the console of the Video Computer System are connected 
to I/O port B as follows: 

Line Connection 

PBO Game Reset switch. The PBO line secs a logic zero when the 
switoh is pressed. 

PB1 Game Select switch. The PB1 line sees a logic zero when 
the switch is pressed. 

PB2 

PB3 TV Type switch. When the switch is in the color position, 
line PB3 sees a logic one signal. This switch goes nowhere 
else. 

PM 

PB5 

PB6 Left Difficulty switch. Line PBS sees a logic one signal 
when the switch is in the up position. 

PB7 Right Difficulty switch. Line PB7 sees a logic one signal 
when the switch la in the up position. 

6.2.3 Keyboard Controller Connections 

Each button on a keyboard controller la an electrical switch that is 
connected between one line from I/O port A and one of the display 
controller registers. All the buttons in the same row (e.g. l f 2 , 
and 3) are connected to the same I/O port line. All the buttons in 
the 3ame column (e.g. 1, k, 7, and a ) are connected to the same 
display generator register. The connections to the left (right) 
controller are shown in Figure 11. 
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Figure 11 


6.2.n Joystick Controller Connections 

In the description of the Joystick controller connections, we will use 
the symbol "Cn" (where "n" runs from 1 to 9) to stand for the n'th pin 
on either the right or the left rear connector. If a Joystick Is held 
so that the red button is in the upper left corner, the following list 
describes the Joystick operation: 

1. Stick not pushed in any direction: Pins Cl, C2, C3, and CM 
are "floating" (that is, not electrically connected to 
anything). 

2. Stick pushed forward: Pin Cl is connected to pin C8 (ground). 

3. Stick pulled backwards: Pin C2 is connected to pin C8 

(ground). 

M. Stick pushed to the left: Pin C3 is connected to pin C8 

(ground). 

5. Stick pushed to the right: Pin CM is connected to pin C8 

(ground). 

6. Red button not pushed: Pin C6 is floating. 

7. Red button pushed: Pin C6 is connected to pin C8 (ground). 
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Pina Cl through CH are connected to lines from RIOT I/O port A. When 
the I/O port lines are read Into the computer, a floating lino will 
show a value of one, while a grounded line will show a value of zero. 
The C6 pin is connected to one of the display generator control 
registers. If the pin is floating, the control register will read a 
negative value, while a grounded pin will read a positive value. 

If the Joystick is pushed diagonally, two pins are supposed to be 
grounded at the same time. For example, moving the stick back and to 
the left should connect both C2 and C3 to C8. In reality, however, 
some Joysticks will work this way while others will not. You may have 
discovered this while playing games that attempt to use this feature. 


6.2.5 Paddle Controller Connections 

As in the Joystick description, we use the symbol Cn to represent the 
n'th pin on either the left or right rear connector. The paddle 
controllers are wired as follows. Two controllers are connected to 
each rear connector. Each controller has a switch button and a dial. 
The dial is connected to a onc-megaohm linear taper potentiometer 
which is at minimum resistance when the dial is turned completely 
clockwise. One of the controllers has its button wired so pressing It 
connects (the otherwise floating) C*l to C8 (ground). This 
controller's potentiometer 1s connected between pins C5 and C7 
(■*■5 volts). Pressing the other controller's button connects pin C3 to 
C8, and its potentiometer is connected between pins C9 and C7. 
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6.3 Atari Display Generator 

The Atari Display Generator is a custom built integrated circuit that, 
under the control of the 6502 microprocessor, can generate a 
sophisticated display on your TV screen, and can produce a wide 
variety of sounds from your TV speaker. There are aotually two kinds 
of displays that the display generator can produce—a "low resolution" 
display (used by the MaglCard monitor for Its TV display) and a "high 
resolution" display (used by some Atari game cartridges to make more 
detailed displays). The high resolution display Is very complex; 
therefore, we can only give a brief description of how its control 
registers work. 

For both kinds of displays, the display is generated one line at 
a time. Thus, to draw an object on the TV screen, a program must keep 
track of which scan line Is being made on the TV screen, and then set 
the proper registers In the display generator to the proper value for 
each line on which the object appears. This Is a tricky business 
which Is one of the reasons why we have provided the DSPL subroutine 
to help you make displays. More information about synchronizing the 
display with your TV set is given in Seotlon 6.5. More Information 
about sound generation Is given in Section 6.4. 

As with the RIOT device, the display generator consists of a set 
of control registers, each with an address with which It is 
referenced. Each control register is either read only or write only. 
The control registers and their functions are as follows: 
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Address (Bead/Write) Function 


00 (W) When bit #1 is set to one, start TV vertical sync 

period. When set to zero, end the vertical sync 
period. 

01 (W) When bit 11 is set to one, start TV vertical 

blanking period. When set to zero, end the 
vertical blank period. 

02 (W) When anything is written into this register, the 

microprocessor will stop executing instructions 
until the begining of the next TV horizontal scan 
line. 

03 (W) Unused 

04 (W) Controls the placement, repetition, and 

magnification of the high resolution masks at 
locations IB and ID. Writing zero into this 
location gives a single, unraagnlfied copy. 

05 (W) Same as 04 except for the masks at locations 1C, 


06 (W) "Left color". Used for IB,ID high resolution 

masks and for the left half of the low resolution 
display. 

07 (W) "Bight color". Used for 1C,IE high resolution 

masks and for the right half of the low 
resolution display. 

08 (W) "Alternate color". Can be used for both halves 

of the low resolution display. 

09 (V) "Background color". This is the color of the 

screen where nothing 1s displayed. 

0A (W) Bit #0 s 1 «> reverse right half of low 

resolution display. 

Bit #1 s 1 => left and right colors used for low 
resolution display (otherwise, both sides are 
"alternate" color). 

0B (W) Bit #3 = 1 *> display IB high resolution mask in 

reversed bit order. 

0C (W) Same as 0B except for 1C high resolution mask. 

0D (W) Most significant four bits (ordered from bit 4 

through bit 7) are the beginning of the 

twenty-bit low resolution mask, 

0E (W) Next eight bits (ordered from bit 7 through 

bit 0) of the low resolution mask. 

OF (W) Last eight bits (ordered from bit 0 through 

bit 7) of the low resolution mask. 
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15 (W) 

16 00 

17 (W) 

18 (W) 

19 00 

1A (W) 

IB (W) 


1C (W) 

ID (W) 

IB (V) 


IF <W) 

20 - 24 (W) 


Each bit in the twenty-bit low resolution mask 
controls whether a corresponding position of the 
current TV scan line will be the low resolution 
color or the background color. The twenty-bit 
mask is actually displayed twice on each line, 
once on the right side of the TV screen and once 
on the left. However, the contents of the bit 
mask registers (0D, 0E, and OF) can be changed by 
the program during the drawing of the line by the 
TV set. Thus, Torty independently controllable 
line segments can be drawn on each scan line 
using the low resolution display (This is how the 
MaglCard monitor and the DSPL subroutine make TV 
displays.). 

A store into one of these locations positions the 
corresponding high resolution mask (IB - IF) 
horizontally within a scan line as determined by 
the delay from the beginning of the scan until 
when the store is made. 

Sound channel #1, sound-type register (only the 
least significant four bits are used). 

Sound channel #2, sound-type register 

Sound channel #1, pitch register (only the least 
significant f^vo bits are used). 

Sound channel #2, pitch register. 

Sound channel #1, volume register (only the least 
significant four bits are used). 

Sound channel #2, volume register. 

High resolution display mask. The bits written 
into this register define the shape of a high 
resolution display object (the most significant 
bit defines the left side of the object). The 
color of the object is set by storing into 06. 

A second high resolution display mask. The color 
is set by storing Into 07. 

Setting bit #1 displays a short interval on the 
scan line (1/160-th of a scan line) in the color 
set by storing into 06. 

Setting bit #1 displays a short interval of the 
scan line (1/l60-th of a scan line) in the color 
set by storing into 07. 

Setting bit #1 displays a short interval of the 
scan line (like 1C and ID) but the color is 
always white. 

Seta the horizontal-position, shift-increment 
value (see description of locations 2A and 2B) 
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25 - 29 (W) 
2A (V) 


2B 


(W) 


30 - 37 (R) 
38 - 3D (R) 


for the high resolution objocts defined using 
locations ID through IF. The values stored here 
should range from -80 (a right shift of 8 places) 
to ♦70 (a left shift of 7 places). The total 
width of a TV scan line is 160 (decimal) high 
resolution display elements (each high resolution 
element is one-fourth the width of a low 
resolution element). 

Additional control of IB through IF high 
resolution objects. 

Writing into this location Increments the 
horizontal position of all the high resolution 
objects by the amounts stored in their associated 
horizontal-position, shift-increment registers 
(locations 20 through 24). 

Storing into this location sets to zero the 
values of all the horizontal-position, 
shift-increment registers (locations 20 through 
24). 

Display generator status information. 

Analogue input from controller connections (sec 
Section 6.2). A negative value indicates an 
input voltage above threshold voltage. 
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6.4 Details of Sound Generation 

The Atari display generator control registers between locations 15 and 
1A can be used to produce sounds from the TV speaker. There are 
actually two Independently controllable sound •’channels''— each of 
which has a pitch register, a volume register, and a sound-type 
register. The sound that comes out of the TV speaker is a mixture of 
the sounds that havo been selected from the two channels. 

The value stored into the pitch register (location 17 for the 
first sound channel, location 18 for the second sound channel) 
specifies the pitch of the sound. Storing a value or 00 produces the 
highest pitch; storing a value of IF produces the lowest pitch. The 
value stored into the volume register (location 19 for the first sound 
channel, location 1A for the second sound channel} specifies the 
volume of the sound. Storing a value of 00 produces silence; storing 
a value of OF produces the loudest' possible sound. The volume of the 
two channels is not totally independent— as one gains volume, the 
other loses volume. The value stored into the sound-type register 
(location 15 for the first sound channel, location 16 Tor the second 
sound channel) specifies the type of sound to be made. Values from 00 
through OF may be stored into these registers. Of the sixteen 
possible values, two (00 and 0D) produce no sound. The other values 
produce a variety of sounds that are difficult to describe. The 
easiest thing to do is to experiment by storing various values into 
the sound registers and listening to what happens ! One final 
comment—because the 6502 executes instructions at a very fast rate 
compared to the length of the sounds that are produced, "real-time" 
manipulation of the sound control registers can produce a wide variety 


of effects. 
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6.5 Details of TV Display Generation 

The most convenient way to make a TV display Is to use the DSPL 
monitor subroutine described in Section 7.1. A program can also make 
a display on the TV screen by storing into the display controller 
registers In a precisely timed manner. The rest of Section 6.5 
describes how to make a display without using the DSPL subroutine. 
Example H In Chapter 2 gives an example of how the procedure described 
below can be used in a program. 


6.5.1 Basic Display Generation Procedure 

Any program that makes a stable display on the TV screen must repeat a 
basic set of operations once every one-sixtieth of a second (the time 
it takes a TV set to draw one frame). The time it takes for the 
computer to execute this "basic loop" can be precisely controlled by 
using the timer contained in the RIOT device (3ee Section 6.1) in 
combination with the display controller register at location 02. If 
the basic loop takes more or less than one-sixtieth of a second to 
execute, the TV pioture will wiggle slightly and may roll vertically. 
The operations in the basic loop are as follows: 

1. Start the vertical-blanking interval. 

2. Start the vertical-sync interval. 

3. End the vertical-sync interval. 

M. End the vertical-blanking interval. 

5. Set up each line of the TV picture as the line is being drawn 
by the TV set. 

6. Go baok to Step 1. 

Eaoh of the steps in the basic loop will now be disoussed in more 


detail 
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6.5.2 Start the Vertical-Blanking and Vertical-Sync Intorvala 
The vertical-blanking and vertical-sync time intervals are begun at 
the same time. The operations necessary to begin the blanking and 
sync intervals are as follows: 

1. Store something (anything) into the display controller 
register at location 02. 

2. Store a byte with bit #1 set into the display controller 

register at location 01. 

3* Store a byte with bit #1 set Into the display controller 

register at location 00. 

The TV set responds to these operations by: 


1. Turning off the "electron gun" that it uses to draw the 
picture on the TV screen. This Is done to keep from messing 
up the TV picture when the gun moves from the bottom of the 
screen to the top. 

2. Starting to move the gun from the bottom of the ourrent TV 
frame to the top of the next frame. 


6.5.3 End the Vertical-Sync Interval 

The vertical-sync interval must have a short (a few hundred 
mioroseconds) fixed duration. The RIOT timer function can be used to 
keep track of how much time is left before the vertical-sync interval 
should be onded. A good procedure to follow is: 


1. Immediately arter the vertical-sync interval has been 

started, store the value 2A into the RIOT timer control 
register at location 0295. This initializes the timer to a 
value of 2A and starts it counting down toward zero. 

2. At this point, there is time for about eighty average 6502 
instructions to be executed beforo the timer roaches zero. 
Your program can use this time to perform any calculations It 
needs to do. 

3. Aftor the program has done its calculations (if there were 
any), it should read location 028k (the time remaining In the 
timer count down). If the value read Is not zero, the 
program should loop baok and read 028k again. 

k. When the program reads a value of zero from location 028k, it 
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should end the vertical-sync interval by writing a zero Into 
the display controller registers at locations 02 and 00 (in 
that order). 

By the end of the vertical-sync interval, the electron gun (still 
turned off because the vertical-blanking interval has not yet ended) 
has reached the top of the screen and is beginning to draw a new Frame 
of the TV picture. 


6.5- 1 * End the Vertical-Blanking Interval 

Unlike the vertical-sync interval, the length of the vertical-blanking 
interval can be made as long as desired. Once the vertical-sync 
interval has ended, continuing the vertical-blanking interval causes 
the lines of the picture at the top of the screen to be blank. 
Because the program will often be very busy forming the display after 
the ( vertical-blanking has ended, much of the computing done by a 
program must be done before vertical-blanking is ended. If your 
program does a lot of computation, the vertical-blanking interval can 
be extended (thus moving the first nonblank line of the picture 
further down the screen, and reducing the total number of nonblank 
lines available for your display). 

If you look at the display produced by different game cartridges, 
you will see the blank area at the top of the screen is larger for 
some games than for others. The games with a larger blank area 
usually need the extra time for computations. At least one game 
(chess) shows a single-color totally-unsynchronized display while it 
is calculating its next move. This gives the program 100$ of the time 
for performing calculations. 

A normal length vertical blanking period can be ended as follows: 

1. Immediately after the vertical-sync Interval has been ended, 
write the value 2*1 into location 0296 (the RIOT's count down 
timer). 
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2. At this point, there Is time for about five hundred and fifty 
average length 6502 Instructions before the timer reaches 
zero. 

3. After the program has performed its calculations, it should 
read location 0284 (the time remaining in the timer count 
down). If the value read is not zero, the program should 
loop back and read 0284 again. 

4. When the program reads a value of zero from location 0284, if 
should end the vertleal-blanking interval by writing a zero 
into the display controller registers at locations 02 and 01 
(in that order). 


6.5.5 Set Up Each Line of the TV Picture 

After the vertical-blanking interval has been ended, the TV's electron 
gun is turned on, and the horizontal lines drawn by the gun will be 
visible on the TV screen. If the above recommended value for the 
length of the vertical-blanking interval is used (i.e. starting the 
RIOT timer by storing 24 into location 0296), the TV set must draw two 
hundred and twenty-eight lines (E4 hex) on the screen before the start 
of the next vertical-sync interval. (However it is very possible that 
the last ten or twenty lines drawn will end up below the bottom of 
your TV screen.) Your program can make its display on the screen by 
telling the display generator what to place on each line of the 
display. 

The program should start out by writing any value into the 
display controller register at location 02. This causes the 6502 
microprocessor to stop executing instructions until the TV set is Just 
beginning to draw the next lino on the screen. The instructions 
immediately following the write into 02 should write into the display 
generator registers needed to produce the display that you want to 
make. 

For example, if you are using the low resolution display feature 


(see Section 6.3)» you must quickly write into locations 0D, 0E, and 
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OF to tell the display generator what pattern is to be displayed on 
the left half of the TV screen. If you want to place a new pattern on 
the right hand aide of the screen, you must then reload the same three 
locations—after the bits loaded into each register have been 
displayed on the left side of the screen, but before they are 
displayed on the right side. The time it takes the TV to draw a line 
is sufficient for about eighteen 6502 instructions to be executed (or 
more precisely, exactly seventy-six microprocessor clock cycles). 


6.5*6 Additional Comments 

If more time la needed for computing between TV frames, the 
vertical-blanking interval can be lengthened and the number of visible 
lines in the display reduced. One line is removed from the visible 
display for every seventy six microprocessor clock cycles added to the 
vertical-blanking Interval. If the picture on your TV "wiggles" 
slightly, the time the program is using to make each TV frame is 
either a little too long or a little too short. Adjust either the 
number of lines in the visible part of the picture, or adjust the 
length of the vertical-blanking Interval until the picture is stable. 
You may find it helpful to dump (using the "Instruction Dump" feature 
of the MagiCard) the MaglCard monitor display subroutine "DSPL" (see 
Section 7.1) to see an example of how a program can generate a TV 


display. 



CHAPTER 7 


MagiCard Monitor Subroutines 


In this section, we describe a number of useful subroutines that 
are part of the MaglCard Monitor program. These subroutines are 
contained in read-only memory so it is impossible for them to be 
overwritten by a programming error. The following information is 
provided for each subroutine: 


1. Subroutine Name—A four letter name for the subroutine. The 
name is given for convenience only and has no meaning to the 
monitor program. 

2. Subroutine Address—The four-hex-digit absolute address of 
the subroutine. 

3. Subroutine Description—A short description of what the 
subroutine does. 

U. Subroutine Calling Procedure—What input arguments the 
subroutine has and where they are to be plaeed before calling 
the subroutine. 

5. Subroutine Outputs—What output arguments are produced by the 
subroutine and where they are to be found. 

6. Subroutine Side Effects—What memory locations and registers 
(other than those registers and memory locations that are 
used for the output parameters) are modified by calling the 
subroutine. 

7. Example—An example of how the subroutine can be used. 


7.1 Refresh TV Display and Read Keyboard Controllers 


Name: DSPL 
Address: FA6F 


Description: This subroutine makes a display on the TV screen (for one 
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"frame" lasting one-sixtieth of a second) and determines if any 
of the keys on the keyboard controllers were pushed during that 
time. Any program that is using DSPL to display information on 
the TV screen must call DSPL at least once each sixtieth of a 
second to maintain a steady picture. A significant amount of the 
allowed tine between calls to DSPL is taken up by the subroutine 
itself before it returns. This leaves enough time for the user 
program to execute about 550 (decimal) average length 
instructions between calls. 

For display purposes, the TV screen is divided into a set of 
equal-sized rectangular regions called "picture elements" or 
"pixels". There are forty-two rows of pixels containing forty 
pixels each. Each pixel can be individually turned "on" (i.e. 
be seen as a small colored rectangle on the TV screen) or turned 
"off" (i.e. be seen as a small black rectangle on the TV 

screen). Furthermore, each pixel has associated with it a unique 
memory bit (called the "pixel-bit"). When the DSPL subroutine is 
called, it uses this pixel-bit to control whether or not the 
pixel will be displayed as "on" or "off". If the pixel-bit is 
set to one, the corresponding pixel will be "on". If the 

pixel-bit is set to zero, the corresponding pixel will be "off". 

The pixel-bits are stored in memory locations F000 through 
F0D1. Because of the complicated way the Atari Video Computer 
System makes a TV display (see Section 6.3) f the pixel-bits are 

stored In memory in a funny way. The subroutine CALP (see 

Section 7*3) can be used to find the location of the pixel-bit 
for any desired pixel. 

Calling Procedure: 

The subroutine is called via the instruction "JSR [A] FA6F". 
DSPL has no input parameters but it does depend on proper 
initialization of the Video Computer System Display Generator. 
This initialization i3 made by the MagiCard Monitor program 
whenever a reset is made (e.g. when the system is powered up or 
when a BRK instruction is executed). Only the colors of the 
display are likely to be usefully changed in a user program. The 
background color is set by storing a value into location 09. The 
pixel's color is set by storing a value into location 08. More 
details about color control can be found in Section 6.3 in which 
the Display Generator is discussed. 

Outputs: 

location 82: indicates if a new key was pressed on the left 
keyboard controller. If the contents of this location are 
negative, no new key has been pressed. If the contents are 
positive, it is the value of the key that wa3 pressed 
(Pressing the key returns a value of 0A, and pressing the 
"#" key returns a value of OB), ir a key is pressed and held 
down, it will only be reported on the first call to DSPL 
unless it is released and pressed again, 
location 83: indicates if a new key was pressed on the right 
keyboard controller. 

location 8A: indicates if a key is currently being pressed on the 
left keyboard controller. The contents of this location are 
set in the same way a3 location 82 except that if a key is 
pressed and held down it will be reported on each call to DSPL 
until it has been released (unlike location 82 where it would 
be reported only once). 

location 8B: Indicates if a key is currently being pressed on the 
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right keyboard controller. 

Side Efrectaj 

The accumulator, X index register, Y index register and condition 
codes are all altered. 

DSPL uses the timer function of the 653? RIOT device (see 
Section 6.1.3). The timer can be read by a user program; 
however, if it is altered between calls to DSPL, TV 

synchronization will be lost. 

DSPL uses the "A" I/O port function of the 6532 RIOT device. The 
I/O port can be used by a user program, but DSPL will modify 
it each time it la called. 

If the "Came Reset" switch on the Video Computer System console 
is depressed when DSPL is called, a BRK instruction will be 
executed forcing a reset of the MagiCard Monitor (see 
Section 7.15.1). This is a useful way to terminate the 
execution of a program that calls DSPL. The I-flag in the 
processor 3tatus register can be set to prevent the reset from 
occurring. 


7.2 Store to Program Memory 


Name: STPM 
Address: FFF7 

Description: Store the contents of the accumulator into a memory 
location in program memory (i.e. between address F000 and F3FF). 
The address at which the accumulator is to be stored is the sura 
of a specified sixteen-bit absolute address (called the "base 
address") and the contents of the Y index register (called the 
"address offset"). Warn ing: The r ,uro of the Y regi ster and 
the low order 8 "bits of the base address sho u ld n ot 
Calling Procedure: exceed FF. 

1. Place the least significant byte of the base address into 
memory location 8C. 

2. Add four to the most significant byte of the base address and 
place the result into memory location 8D (i.e., if the base 
address 13 FOOD, zero should be placed into location 8C and, 
F4 should be placed into location 8D). 

3. Place the value of the address offset into the Y index 
register. 

4. Place the value to be stored into the accumulator. 

5. Execute the instruction "JSR [A] FFF7". 

Outputs: None 
Side Effects: None 

Example: The following program fragment stores a one into memory 
location F106: 

LDA [I] 00 clear the accumulator 

STA [Z] 8C clear location 8C 

LDA [I] F5 load accumulator with FI ♦ 4 

STA [Z] 8D put value F5 Into location 8D 
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LDY [I] 06 place offset value of 6 into Y 

LDA [I] 01 set accumulator to one 

JSR [A] FFF7 call subroutine STPM 


7.3 Calculate Address and Mask for Plotting 


Name: CALP 

Address: FFBE 

Description: Calculate an address and bit mask to use for plotting. 
This subroutine aids MagiCard users in making displays on the TV 
screen. As explained in Section 7-1* the display generating 
subroutine produces a display consisting of pixels each with an 
associated pixel-bit in memory. The CALP subroutine takes as 
input the pixel's position on the TV screen (i.e. t its row number 
and column number) and returns ns output the information needed 
to set (or clear) the pixel bit. 

Calling Procedure: 

1. Place the Horizontal position of the pixel into memory 
location 8E. The horizontal position is a nunber between zero 
and thirty-nine (27 hex) where a value of zero specifying the 
left side of the screen and a value of thirty-nine specifying 
the right side. 

2. Place the vertical position of the pixel into memory location 

8F. The vertical position is a number between zero and 

forty-one (29 hex) where a value of zero specifies the top of 
the screen and a value of forty-one specifies the bottom. 

3. Execute the instruction "JSR (A] FFBE". 

Outputs: 

Y index register: when added to F000, the value contained in the 
Y index register gives the address of the byte containing the 
pixel-bit. 

Accumulator: has a bit set that corresponds to the pixel-bit 
within the byte. 

Side Effects: 

N,Z,C,and V-flags are altered 
memory location 90 is altered 

Examples: The following examples assume that memory locations 8C and 
8D have been previously filled with 00 and FH respectively, and 
that memory locations 8E and 8F contain the horizontal and 
vertical position of the pixel being worked with. 

Example 1: turn on the selected pixel-bit 

JSR [A] FFBE calculate address and bit mask 

ORA [Y] F000 "OR" new bit with others 

JSR [A] FFF7 store results (with subroutine 

STPM) 


Example 2: turn off the selected pixel-bit 
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right keyboard controller. 

Side Effects: 

The accumulator, X index register, Y index register and condition 
codos are all altered. 

DSPL uses the timer function of the 6532 RIOT device (see 
Section 6.1.3)* The timer can be read by a user program; 
however, If it is altered between calls to DSPL, TV 
synchronization will be lost. 

DSPL uses the "A" I/O port function of the 6532 RIOT device. The 
I/O port can be used by a user program, but DSPL will modify 
It each time It Is called. 

If the "Game Reset" switch on the Video Computer System console 
13 depressed when DSPL is called, a BRK Instruction will be 
executed forcing a reset of the MaglCard Monitor (see 
Section 7.15.1). This is a useful way to terminate the 
execution of a program that calls DSPL. The I-flag in the 
processor status register can be set to prevent the reset from 
occurring. 


7*2 Store to Program Memory 


Name: STPM 
Address: FFF7 

Description: Store the contents of the accumulator Into a memory 
location In program memory (i.e. between address F000 and F3FF). 
The address at which the accumulator is to be stored is the sum 
of a specified sixteen-bit absolute address (called the "baso 
address") and the contents of the Y index register (called the 
"address offset"), learn ing: T he sum of the Y register and 
tho low order 8 VTLs of the base address should not 
Calling Procedure: oxceed FF. 

1. Place the least significant byte of the base address into 
memory location 8C. 

2. Add four to the most significant byte of the base address and 
place the result into memory location 8D (i.e., If the base 
address Is F000, zero should be placed Into location 8C and, 
F4 should be placed Into location 8D). 

3* Place the value of the address offset Into the Y index 
register. 

4. Place the value to be stored into the accumulator. 

5. Execute the Instruction "JSR [A) FFF7". 

Outputs: None 
Side Effects: None 

Example: The following program fragment stores a one into memory 
location F106: 

LDA (I) 00 clear the accumulator 

STA [Z] 8C clear location 8C 

LDA (I) F5 load accumulator with FI ♦ 4 

STA [Z] 8D put value F5 into location 8D 
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LDY [I] 06 place offset value of 6 Into Y 

LDA [I] 01 set accumulator to one 

JSR [A] FFF7 call subroutine STPM 


7.3 Calculate Address and Mask for Plotting 


Name: CAI.P 

Address: FFBE 

Description: Calculate an address and bit mask to use for plotting. 
This subroutine aids MagiCard users in making displays on the TV 
screen. As explained in Section 7.1, the display generating 
subroutine produces a display consisting of pixels each with an 
associated pixel-bit in memory. The CALP subroutine takes as 
input the pixel's position on the TV screen (i.e., its row number 
and column number) and returns as output the information needed 
to set (or clear) the pixel bit. 

Calling Procedure: 

1. Place the Horizontal position of the pixel into memory 
location 8E. The horizontal position is a number between zero 
and thirty-nine (27 hex) whore a value of zero specifying the 
left side of the screen and a value of thirty-nine specifying 
the right side. 

2. Place the vertical position of the pixel into memory location 

8F. The vertical position is a number between zero and 

forty-one (29 hex) where a value of zero specifies the top of 
the screen and a value of forty-one specifies the bottom. 

3. Execute the instruction "JSR [A] FFBE". 

Outputs: 

Y index register: when added to F000, the value contained in the 
Y index register gives the address of the byte containing the 
pixel-bit. 

Accumulator: has a bit set that corresponds to the pixel-bit 
within the byte. 

Side Effects: 

N,Z,C,and V-flags are altered 
memory location 90 is altered 

Examples: The following examples assume that memory locations 8C and 
8D have been previously filled with 00 and F<) respectively, and 
that memory locations 8E and 8F contain the horizontal and 
vertical position of the pixel being worked with. 

Example If turn on the selected pixel-bit 

JSR [A] FFBE calculate address and bit mask 

ORA [Y] F000 "OR" new bit with others 

JSR [A] FFF7 store results (with subroutine 

STPM) 


Example 2: turn off the selected pixel-bit 



MagiCard Monitor Subroutines 


PAGE 7-5 


JSR [A] FFBE calculate the address and bit ma3k 

EOR [I] FF complement bit mask 

AND CT] FOOO turn off selected bit 

JSR [A] FFF7 store the result 


Example 3* reverse the state of the pixel-bit (turn it off if it is 
on, or turn it on if it is off) 

JSR [A] FFBE calculate the address and bit mask 

EOR [I] FOOO complement the pixel-bit bit 

JSR (A) FFF7 store the result 


Example 9: test if the pixel Is on 

JSR [A) FFBE calculate the address and bit mask 

AND (Y) FOOO this will clear the Z-flag if the 

pixel 'a bit is on 

BNE (somewhere) branch if the pixel is on 


7 - *1 Place One Character Into The Display 


Name: ONEC 

Address: FB67 

Description: Set the pixel-bits needed to plot a character. 

Section 7.1 explains how the state of each pixel displayed on the 
TV screen (by the TV display subroutine) is controlled by the 
value of its associated pixel-bit in memory. By setting the 
proper combination of pixel-bits, it is possible to display 
characters (letters and numbers) on the screen as well. Each 
character occupies a rectangle four pixels wide and six pixels 
high (including the "off" pixels that separate adjacent 
characters). The TV screen can hold seven linos of ten 

characters each. ONEC is called to set the pixel bits nece33ary 
(and clear the pixel-bits that are not necessary) to place a 
character onto the TV screen at the selected position. 

Calling Procedure: 

1. Place the line number of the character position on the screen 

to be filled into location 8F. The line number is a number 

between zero (specifying tho top line of characters) and six 
(specifying the bottom line of characters). 

2. Place the character number of the character position on the 
screen to be filled into location 8E. The character number la 
a number between zero (specifying the left side of the screen) 
and nine (specifying the right side of the screen). Neither 
the line nor character numbers are checked to see if they are 
legal values. The use of illegal values may produce various 
problems with the display or with the user program. 

3. Place the ASCII code (see Appendix B) for the character to be 
displayed Into memory location 98 ♦ character number (e.g., 
when displaying the character at character number 9» place the 
ASCII code into location 90 ♦ 9 * Al). 
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4. Execute the instruction "JSR [A] FB67". 


Outputs: None 
Side Effects: 

The accumulator, X index register, Y Index register, and 
condition codes arc altered. 

Locations 82,03 and 90 through 97 are modified. 

Thi3 routine cannot be called more than twice between calls to 
DSPL if loss of TV synchronization is to be avoided. 


Example: The following program fragment sets the pixel-bits required 
to display the letter "Z" in the bottom right-hand corner of the 
TV screen: 


LDA [I] 09 

STA [Z] BE 
LDA [I] 06 

STA IZJ 8F 
LDA [I] 5A 
STA [Z] A1 
JSR [AJ FB67 


load 09 into accumulator 

store into location 8E 

load 06 into accumulator 

store Into location 8F 

load ASCII for "Z" into accumulator 

store into A1 

call ONEC 


7.5 Place a Line of Characters Into the Display 


Name: DOLN 

Address: FCC8 

Description: Set the pixel-bits necessary to display an entire line of 

characters. This subroutine is similar to subroutine ONEC except 

it work3 with an entire line of characters-not Just one. 

Calling Procedure: 

1. Place the line number into location 8F. The line number is a 
value from zero (specifying the top of the TV screen) to six 
(specifying the bottom of the TV screen). 

2. Place the ASCII codes (see Appendix B) for the characters to 
be displayed Into locations 98 through A1 (location 98 is for 
the left most character on the screen). 

3. Execute the Instruction "JSR [A] FCC8". 

Outputs: None 

Side Effects: 

The accumulator, X Index register, Y index register, and 
condition codes are altered. 

DOLN calls the DSPL subroutine to keep the display going; 
however, it destroys the contents of locations 8A and 8B. To 
find out the value of the key currently pressed on each 
keyboard controller, it is necessary to call DSPL after the 
return from DOLN. 

Upon return from a call to DOLN, about half the time between 
calls to DSPL necessary for TV synchronization will have 
elapsed. 
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7.6 Fill the Line Buffer With Blanks 


Name: BFIL 
Address: FDAC 

Description: This subroutine fills locations 98 through A1 with the 
ASCII code for a blank character (20). This range of memory 

locations is used by the DOLM subroutine to set the pixel-bits 

necessary to display a line of characters. It is often desired 
to display a line of text that contains blanks in many of the ten 
character positions. To do this, you can call the BFIL 

subroutine, place the ASCII values for the nonblank characters 

Into the proper places, and the call the DOLN subroutine. 

Calling Procedure 

Execute the instruction: JSR [A] FDAC 
Outputs: None 
Side Effects 

The accumulator is set to 20. 

The X index register is set to zero. 

The N-flag is clear. 

The Z-flag is set. 


7.7 Scroll the Pixel-bits Up One Character Line 


Name: SCHL 
Address: FD8D 

Description: This subroutine modifies the pixel-bits such that when 
the DSPL subroutine is called again, each pixel on the TV screen 
will be moved up 6 pixel lines (or equivalently, one line of 
characters). The former top six rows of pixel-bits are lost and 
the new bottom six lines of pixel-bits will contain a random bit 
pattern. It is expected that the DOLN subroutine will be called 
to set the pixel-bits for the bottom of the screen with the 
values needed to display a new line of text. This subroutine is 
used by the MagiCard Monitor program when it performs the hex 
dump and instruction dump functions. 

Calling Procedure: 

Execute the instruction "JSR [A] FD8D" 

Outputs: None 
Side Effects: 

The accumulator is set to 20. 

The X and Y index registers are set to zero. 

The condition codes are altered. 

Memory locations 98 through AT are set to 20 (ASCII blanks). 
Memory location 8F is set to the value 06. 

SCRL calls the DSPL subroutine three times during its execution 
in order to maintain the TV picture synchronization. The 
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keyboard data returned by DSPL la ignored so the record of a 
new key being pressed will be lost if it occurs during the 
call to SCRL. In practice, however, the call to SCRL is short 
enough that the loss of key press data is almost never 
noticeable. 

Note that SCRL leaves things very well set up to set the 
pixel-bits for a new line of text by calling DOLN. 


7.8 Convert a Byte of Data Into ASCII 


Name: NUMC 

Address: FCB1 

Description: This subroutine takes as input a one byte number and 
produces as output the two ASCII code values that are the 
hexadecimal representation of the number. The NUMC subroutine 
can be used in conjunction with the ONEC (or DOLN) subroutine and 
the DSPL subroutine to display the hexadecimal representation of 
a number on the TV screen. 

Calling Procedure: 

1. Place the value to be converted into the accumulator 

2. Place into the X index register the memory location (with 

respect to location 98) where the first of the two ASCII code 
values is to be place. That is, if the X index register 

contains a zero, the first ASCII code value will be placed 
into location 98. If the X index register contains an eight, 
the first ASCII code value will be placed into location 

98 ♦ 8 * AO. The range of memory locations from 98 through A1 
is used by the ONEC (or DOLN) subroutine as part of the 
character display procedure. 

3. Execute the instruction "JSH (A) FCB1". 

Outputs: 

The memory locations at the addresses 98 ♦ X index register and 

99 ♦ X index register are filled with the ASCII code values 
representing the hexadecimal value for the input value. 

The X index register is incremented by two (so that another call 
to NUMC will fill the next two memory locations with ASCII 
code values). 

Side Effects: 

The accumulator is set to the ASCII code value for the least 
significant part of the input value. 

The C and Z-flags arc zero. 

The N and V-flags are altered. 


7.9 Convert Half a Byte of Data Into ASCII 

Name: ENCL 


Address: FCBA 
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Description: This subroutine Is identical with subroutine NUMC with 
the following two exceptions: 

1. Only the lower four bits of the accumulator are 
converted into ASCII code. 

2. The X index register is Incremented by one instead of by 
two. 


7.10 Accumulate Hex Digits 


Name: PSHD 


Address: FD7D 


Description: This subroutine is used to accumulate a four-hex-diglt 

number, one hex digit at a time. Each time PSHD is called, the 

contents of memory locations 80 and 8l are modified as follows: 

1. The upper-four bits of location 81 are discarded. 

2. The lower-four bits of location 81 are moved into the 

upper-four bits of location 81. 

3. The upper-four bits of location 80 are moved Into the 

lower-four bits of location 81. 

4. The lower-four bits of location 80 are moved into the 

upper-four bits of location 80. 


5. The lower-four bits of the accumulator are moved Into 
the lower-four bits of location 80. 


The most useful way to think of the action of this subroutine is 
as a "shift" of the four-digit hex number contained in 
locations 80 and 8l. The most-significant hex digit (the 
upper-four bits in location 81) is lost, and a new 
least-significant hex digit is obtained from the lower-four bits 
of the accumulator. The HagiCard monitor program uses this 
subroutine to accumulate the hex digits entered with the keyboard 
controller (the contents of locations 81 and 80 are displayed by 
the monitor on the upper right-hand corner of the TV screen). 


Calling Procedure: 

1. Place the value of the new hex digit into the accumulator 

2. Execute the instruction "JSR [A] FD7D". 


Outputs: None 
Side Effects: 

The accumulator contains the value of the hex digit shifted out 
of the upper-four bits of location 81. 

The X index register is set to zero. 

The Z-flag is set. 

The N-flag Is clear. 
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The C-flag is altered. 


7.11 Add One to "Fetch Address" and Compare to "Cend Address" 


Name: INCD 


Address: FC9D 

Description: One is added to the sixteen-bit value of the 

"Fetch Address" (least-significant byte in location 86, 
most-significant byte in location 87) and the result is compared 
to the value of the sixteen-bit value of the "Cend Address" 
(least-significant byte in location 8C, most-significant byte in 
location 8D). 

Calling Procedure: 

Execute the instruction "JSR [A) FC9D". 

Outputs: 

The Z-flag is set if the "Fetch Address" equals the 

"Cend Address" (after one hao been added to the "Fetch Address"). 

Side Effects: 

The accumulator, C-flag, V-flag, and N-flag are altered. 


7.12 Add Accumulator to "Fetch Address" and Compare 


Name: BMPB 
Address: FC9F 

Description: The same as subroutine INCH except the contents of the 
accumulator is added to the "Fetch Address" instead of one. 
(Note: The value contained in the accumulator is treated as an 
eight-bit unsigned number. For example, if the accumulator 
contains the value "FF", then two hundred and fifty-five will be 
added to the "Fetch Address".) 


7.13 Determine Instruction Name 


Name: INSN 
Address: FCfi3 

Description: This subroutine accepts as input one of the possible 
instruction opcode values, and returns as output the position of 
the three-ASCII-character instruction name within a table of 
instruction name3. 


Calling Procedure: 
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1. Place the value of the instruction opcode into the 
aocuaulator. 

2. Execute the instruction "JSR [A] FC83". 


Outputs: 

The accumulator contains the position (from zero to sixty) of the 
instruction name within a table of instruction names. The 
Instruction-name table begins at memory location F9A0. Each 
entry in the table Is three bytes long and contains the ASCII 
character codes for the instruction name. If the accumulator 
returns with a value of zero, the input accumulator value was not 
a legal 6502 opcode. In this case, the associated table entry 
(entry zero) contains the nonexistent instruction name "ILL" 
indicating an illegal instruction. 

Side Effects: 

The Z, C, V, and N-flags are altered. 

Memory location 93 la altered. 


7.1 1 * Determine Instruction Addressing Mode 


Name: ADTY 
Address: FCHF 

Description: This subroutine accepts as input ono of the possible 
instruction opcodes,and returns as output the position of the 
two-ASCII-character addressing mode name within a table of opcode 
names. 

Calling Procedure: 

1. Place the value of the instruction opcode into the 
accumulator. 

2. Execute the instruction "JSR [A] FCJJF" 

Outputs: 

The accumulator contains the position (from zero to eleven) of 
the addressing mode name within a table of addressing-mode names. 
The table begins at memory location FA57. Each entry in the 
table Is two bytes long and contains the ASCII character codes 
for the addressing-mode name. The addressing-mode names are the 
same as those used by the MaglCard monitor instruction-dump 
function. A negative value in the accumulator Indicates that the 
input accumulator value was not a legal 6502 opcode. 

Side Effects: 

1. The Z and N-flags are altered. 

2. Hemory location 93 is altered. 


7.15 Determine Instruction Length 


Name: INLN 
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Address: FC3D 

Description: This subroutine accepts a3 input one of the possible 
addressing-mode table locations (as returned by the ADTY 
subroutine), and returns as output the number of bytes In the 
instruction. 

Calling Procedure: 

1. Place the value of the addressing-mode table position into the 
accumulator. (The Z-flag and N-flag values must reflect the 
value in the accumulator.) 

2. Execute the instruction "JSR [A] FC3D" 

Outputs: 

The accumulator contains the number of bytes in the Instruction 
(including the opcode byte). 

Side Effects: 

The Z, N, V, and C-flags are all altered. 


7.16 Other Monitor Addresses 

In this section, we describe some locations within the monitor program 
that, while they are not subroutines, are of potential interest. Some 
of these locations can be Jumped to by a user program to cleanly go 
back to the monitor program. Other of the locations are given as a 
guide to those who wish to examine in more detail the monitor program 
Itself by displaying the monitor program's instructions via the 
MagiCard "Ins Dump" function. 


7.16.1 Reset Entry Point 


Name: RSET 
Address: FE5F 

The microprocessor starts executing instructions at this location 

whenever it is powered up or when a BRK instruction is executed (and 
the 1-flag in the processor status register is clear). The following 
operations are then performed: 

1. The I-flag in the processor status register is cleared. 

2. The D-flag in the processor status register is cleared (the 

monitor program will not work in decimal mode). 

3. The stack-pointer register is set to FF. 

H. Memory locations 80 through A9 are set to zero. 

5. The display controller is initialized. 

6. All the display pixel-bits are cleared (memory locations 

F000 through F0D1). 
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7. I/O port D of tho RIOT la set to input mode. 

8. The DOLN subroutine la called to act the pixel-bits needed to 
display the message "CMX-2" on the screen. 

9. The main program of the MagiCard monitor Is entered (see the 
description of MAIN in the next section). 

A user program can also Jump to this location if it wishes to go back 
to the MagiCard monitor program. 


7.16.2 Beginning of Monitor Main Program 


Name: MAIN 

Address; FE96 This is the beginning of the main program for the 
MagiCard monitor. A user program can Jump to this location if it is 
desired to return to the monitor program without performing the 
initialization operations that would be made by a Jump to RSET. 
Because a Jump to MAIN bypasses these initialization operations, a 
Jump to MAIN will cleanly pass control to the monitor program only if: 

1. The stack-pointer register is set to FF. 

2. The display controller is reasonably well initialized. 

A successful pass of control to the monitor program does not clear the 
screen but will cause a single blinking pixel to appear on the TV 
screen. If this does not happen, it is possible that the user program 
has set the color of the display to black. This problem can be cured 

by storing a number (such as 55) into memory location 08 (this sets 

the color of the display). If storing into 08 does not help, you can 
try to restart tho monitor by pressing the "Came Reset" switch. This 
will perform the normal monitor reset sequence, but it is better than 
powering down the Video Computer System. Finally, if all else fails, 
you can regain control of the computer by turning the power off 
briefly. 


7.16.3 Disassembler Program 


Name: D1SA 

Address: FDB6 This is the beginning of the "instruction dump" portion 
of the MagiCard monitor program (executed when the "Ins Dump" key is 
pressed), 


7.16.*! Cassette Write Program 


Name: CVR7 
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Address: FCPA This Is the beginning of the "cassette write" portion 
of the MagiCard monitor program (executed when the "Cwrlte" key is 
pressed). 


7.16.5 Cassette Head Program 


Name: CRED 

Address: FD3*I This is the beginning of the "cassette read" portion of 
the MagiCard monitor program (executed when the "Cread" key is 
pressed). 


7.16.6 Hex Dump Program 


Name: HEXD 

Address: FE30 This Is the beginning of the "hexidecimal dump" portion 
of the MagiCard monitor program (executed when the "Hex Dump" key is 
pressed). 


7.16.7 Start User Program Execution 


Name: GO 

Address: FE58 This is the beginning or the "run user program" portion 
of the MagiCard monitor program (executed when the "Run" key is 
pressed). 


7.16.8 Relative Address Calculation 


Name: RELC 

Address: FF51 This is the beginning of the 
"calculate relative address" portion of the MagiCard monitor program 
(executed when the "Relc" key 13 pressed). 
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Second Hex Digit 


First Hex 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

c 

D 

E 

F 

Digit 















16 


0 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

15 

1 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

•:V 

29 

30 

31 

2 

32 

33 

Vi 

35 

36 

37 

38 

39 

40 

61 

68 

63 

44 

65 

66 

67 

3 

68 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 

61 

62 

63 

4 

66 

85 

66 

67 

68 

69 

70 

71 

72 

73 

76 

75 

76 

77 

■•o 

79 

5 

80 

81 

82 

83 

84 

85 

86 

87 

88 

89 

90 

91 

92 

93 

96 

95 

6 

96 

9? 

98 

99 

100 

101 

102 

103 

104 

105 

106 

107 

108 

109 

110 

111 

7 

112 

113 

114 

115 

116 

117 

118 

119 

120 

121 

122 

123 

124 

125 

126 

127 

8 

128 

129 

130 

131 

132 

133 

136 

135 

136 

137 

138 

139 

140 

161 

162 

163 

9 

166 

1*15 

146 

167 

148 

169 

150 

151 

152 

153 

159 

155 

156 

157 

158 

159 

A 

160 

161 

162 

163 

164 

165 

166 

167 

168 

169 

170 

171 

172 

173 

176 

175 

B 

176 

177 

178 

179 

180 

181 

182 

it.-i 

184 

185 

186 

187 

188 

189 

190 

191 

C 

192 

193 

194 

195 

196 

197 

198 

199 

200 

201 

202 

203 

jj-j 

205 

206 

207 

D 

208 

209 

210 

211 

212 

213 

214 

215 

216 

217 

218 

219 

220 

221 

222 

223 

E 

226 

225 

226 

2.17 

228 

229 

230 

231 

232 

233 

236 

235 

236 

&! 

238 

239 

F 

260 

241 

242 

263 

244 

265 

246 

267 

248 

269 

250 

251 

252 

253 

256 

255 


To find the hex equivalent of a decimal number, first find the decimal 
number in the chart, and then read off the first and second hex digits from 
the row and column the decimal number is found in. To find the decimal 
equivalent of a hex number, locate the proper row and column pointed to by 
the first and second hex digits, then read off the decimal entry. For 
example, hex AB Is decimal 171; decimal 212 is hex D4. 
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The MaglCard character display subroutine uaea a subset of the 
"ASCII" character set to specify the character to be displayed. The 
missing ASCII codes 00 - IF map to NO - 5F and 60 - 7F map to 


20 - 3F. The possible ASCII character codes and the corresponding 
character for each are given below: 


ASCII Code Character I ASCII Code Character 

20 blank I A0 t 

21 I | 41 A 

22 ” I A2 B 

23 t I A3 C 

2A $ I AA D 

25 * I A5 E 

26 A I A6 F 

27 ' I A7 0 

26 ( | A8 H 

29 ) I A9 I 

2A • I AA J 

2B * I AD K 

2C , I AC L 

2D - I ad m 

2E . | AE N 

2P / I AF 0 

30 0 | 50 P 

31 1 I 51 Q 

32 2 I 52 R 

33 3 I 53 S 

3A A I 5A T 

35 5 I 55 U 

36 6 I 56 V 

37 7 I 57 M 

38 8 | 58 X 

39 9 I 59 7 

3A : I 5A Z 

38 i I 5B C 

3C < I 5C \ 

3D = I 5D ) 

3E > I 5E 

3F ? I 5F 
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On thla and the next page, we llluatrate how the MaglCard 


displays 

each 

of Its 

characters 

on the 

TV soreen. 


20 

1 21 

" 22 

9 23 

$ 2k 

% 25 A 26 

' 27 

B 

X 

X X 


XXX 

X X 

X 

L 

X 

X X 

X X 

XX 

X XX 

X 

A 

X 



X 

X X 


N 



X X 

XX 

X XX 


K 

X 



XXX 

X XX 



( 28 

) 29 

• 2A 

♦ 2B 

. 2C 

- 2D 

. 2E 

/ 21 

X 

X 







X 

X 

X 

X 




X 

X 

X 

X X 

XXX 


XXX 


X 

X 

X 

X 

X 

X 



X 

X 

X 



X 


X 



0 30 

1 31 

2 32 

3 33 

k 3* 

5 35 

6 36 

7 3' 

X 

X 

XXX 

XXX 

X X 

XXX 

XXX 

XXX 

X X 

X 

X 

X 

X X 

X 

X 

X 

X X 

X 

XXX 

XXX 

XXX 

XXX 

XXX 

X 

X X 

X 

X 

X 

X 

X 

X X 

X 

X 

X 

XXX 

XXX 

X 

XXX 

XXX 

X 


8 38 

9 39 

: 3A ! 3B 

< 3C 

= 3D 

> 3E 

? 31 

XXX 

XXX 


X 


X 

XX 

X X 

X X 

X X 

X 

XXX 

X 

X 

XXX 

XXX 


X 


X 

X 

X X 

X 

X 

X 

XXX 

X 


XXX 

X 

X X 

X 


X 

X 
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e <<o 

A *11 

B *12 

C 43 

D 44 

E 45 

F 46 

C 47 


XXX 

XX 


X 

XXX 

XXX 

XXX 

XXX 

X X 

X X 


X 

X 

X 

X X 

XXX 

XXX 

XX 

XXX 

XXX 

XXX 

XXX 

XXX 

XXX 

X X 

X X 

X 

X X 

X 

X 

X 


X X 

XX 

XXX 

XXX 

XXX 

X 

XXX 

H 48 

I 49 

J 4A 

K 4B 

L 4C 

M 4D 

N 4E 

0 4F 

X X 

X 

X 

X 

X 

X X 



X X 


X 

X 

X 

XXX 



XXX 

X 

X 

X X 

X 

X X 

X 

XXX 

X X 

X 

X X 

XX 

X 

X X 

XXX 

X X 

X X 

X 

XXX 

X X 

XXX 

X X 

X X 

XXX 

P 50 

Q 51 

R 52 

s 53 

T 54 

U 55 

V 56 

W 57 

XXX 



XX 

X 



X X 

X X 

XXX 

X 

X 

XXX 

X X 


X X 

XXX 

X X 

XX 

X 

X 

X X 

X X 

X X 

X 

XXX 

X X 

X 

X 

XXX 

X X 

XXX 

X 

X 

X 

XX 

X 

X 

X 

X X 


X 58 

Y 59 

Z 5A 

C 5B 

5C 

) 5D 

* 5E 

_ 5F 


X X 

XXX 

XX 


XX 

X 



X X 

X 

X 

X 

X 

X X 


X X 

X 

X 

X 

X 

X 



X 

X 

X 

X 

X 

X 

X 


X X 

X 

XXX 

XX 


XX 

X 

XXX 
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6502 INSTRUCTION SUMMARY 


First Hex 
Digit 
0 
1 
2 
3 
n 

5 

6 

7 

8 
9 
A 
B 
C 
D 
E 
F 


Second 

0 1 2 
BRK ORA X) 

BPL ORA )Y 

JSR AND X) 

BMI AND )Y 

RTI EOR X) 

BVC EOR )Y 

RTS ADC X) 

BVS ADC )Y 

STA X) 

BCC STA )Y 

LDY I LDA X) 

BCS LDA )Y 

CPY I CMP X) 

BNE CMP )X 

CPX I SBC X) 

BEQ SBC )Y 


Hex Digit 

3 


BIT Z 


STY Z 
STY ZX 
LDX I LDY Z 

LDY ZX 
CPY Z 


CPX Z 


ORA Z ASL Z 
ORA ZX ASL ZX 
AND Z ROL Z 
AND ZX ROL ZX 
EOR Z LSR Z 
EOR ZX LSR ZX 
ADC Z ROH Z 
ADC ZX ROR ZX 
STA Z STX Z 
STA ZX STX ZY 
LDA Z LDX Z 
LDA ZX LDX ZY 
CMP Z DEC Z 
CMP ZX DEC ZX 
SBC Z INC Z 
SBC ZX INC ZX 


First Hex 
Digit 
0 
1 
2 

3 

4 

5 

6 

7 

8 
9 
A 
B 
C 
D 
E 
F 


8 

PHP 

CLC 

PLP 

SEC 

PHA 

CLI 

PLA 

SEI 

HEX 

TYA 

TAY 

CL? 

INY 

CLD 

INX 

SED 


Second Hex Digit 


9 A 

ORA I ASL Acc 

ORA Y 

AND I ROL Acc 

AND Y 

EOR I LSR Aco 

EOR Y 

ADC I ROR Acc 

ADC Y 

TXA 

STA Y TXS 

LDA I TAX 

LDA Y TSX 

CMP I DEX 

CMP Y 

SBC I NOP 

SBC Y 


C D 

ORA 
ORA X 

BIT AND 

AND X 

JMP EOR 

EOR X 

JMP () ADC 

ADC X 

STY STA 

STA X 

LDY LDA 

LDY X LDA X 

CPY CMP 

CMP X 

CPX SBC 

SBC X 


E F 

ASL 
ASL X 
ROL 
ROL X 
LSR 
LSR X 
ROR 
ROR X 
STX 

LDX 
LDX Y 
DEC 
DEC X 
INC 
INC X 
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Accumulator Instructions 


operation 

Inun 

Addressing Mode 
Abs z-page lnd,x 

lnd,y 

z,x 

abs.x 

aba.y 


I 

A 

2 

X) 

>Y 

ZX 

X 

Y 

ADC 

69 

6D 

65 

61 

71 

75 

7D 

79 

AND 

29 

2D 

25 

21 

31 

35 

3D 

39 

CMP 

C9 

CD 

C5 

Cl 

D1 

D5 

DD 

09 

EOR 

99 

4D 

45 

in 

51 

55 

5D 

59 

LDA 

A9 

AD 

A5 

A1 

B1 

B5 

BD 

B9 

ORA 

09 

OD 

05 

01 

11 

15 

ID 

19 

SBC 

E9 

ED 

E5 

El 

FI 

F5 

FD 

F9 

STA 


8D 

85 

81 

91 

95 

9D 

99 


One-Operand Instructions 




Addressing Mode 


operation 

Acc 

Abs 

z-page z t x 

abs,x 



A 

Z 

ZX 

X 

ASL 

OA 

OE 

06 

16 

IE 

DEC 


CE 

C6 

D6 

DE 

INC 


EE 

E6 

F6 

FE 

LSR 

4A 

4E 

46 

56 

5E 

ROL 

2A 

2E 

26 

36 

3E 

ROR 

6A 

6E 

66 

76 

7E 



Index Register 

Instructions 



Addressing Mode 


operation 

I mm 

Abs 

z-page z,x 

Abs ,x 


I 

A 

Z 

ZX 

X 

CPX 

EO 

EC 

E4 



CPY 

CO 

CC 

C4 



LDX 

A2 

AE 

A6 



LDY 

AO 

AC 

A4 

B4 

BC 

STX 


8E 

86 



STY 


8C 

84 

94 




Miscellaneous 

Instructions 


DEX CA 

BCC 90 

CLC 18 

PHA 48 

NOP 

EA 

DEY 88 

BCS BO 

SEC 38 

PHP 08 

BRK 

00 

INX EB 

BEQ FO 

CLD D6 

PLA 68 

BIT A 

2C 

I MY C8 

BMI 30 

SED F8 

PLP 28 

BIT Z 

24 

TAX AA 

BNE DO 

CLI 58 

BTI 40 

JSR 

20 

TAY A8 

BPL 10 

SEX 78 

RTS 60 

JMP A 

4C 

TSX BA 

BVC 50 

CLV B8 


JMP () 

6c 

TXA 8A 

BVS 70 






TXS 9A 
TYA 98 



APPENDIX D 


"Life"—a sample program 


When we looked Tor an idea for a typical moderately large sample 
program, the "Life" game invented by Prof. John Horton Conway of the 
University of Cambridge seemed a natural choice. Life was first 
presented by Martin Gardner in the Mathematical Games section of 
"Scientific American" in October 1970, then again in Pebuary 1971 
along with an introduction to cellular automata theory, from which the 
game was evolved. Since then the game has achieved a continuing 
popularity, with numerous articles appearing in such magazines as 
"Byte" and "Kilobaud", references in serious mathematical texts and 
sporadic newsletters. 

Life consists of rules that govern the development of patterns of 
dots on a rectangular grid. Each dot is considered to be a "live 
cell"; a cell (or grid element) that is empty is considered to be 
"dead". Each cell has eight neighbors surrounding it. By counting 
the living neighbors of each cell (empty or not) and applying the 
following rules to all the cells in a grid at once, a new "generation" 
is formed. 

1. Any live cell with 2 or 3 live neighbors survives. 

2. Any live cell with 0 or 1 living neighbors dies (of 

loneliness). 

3. Any live cell with H or more neighbors dies (of 

overcrowding). 

Any empty (or dead) cell with exactly 3 live neighbors 13 
"born" (comes to life). 


Even patterns of only a few dots can evolve in surprising and 
interesting ways. Some patterns are static, dots arranged adjacent 
to each other In a square is the simplest example. Some patterns 
oscillate, and return to their initial configuration aTtcr 2 to 
hundreds of generations in some cases. Three dots in a vertical line 
will alternate with 3 dots in a horizontal line, to make the simplest 
oscillator. A very simple pattern will often explode into chaotic 
activity before eventually settling down to static or oscillating 
components. Try 3 vertical dots (like the simple oscillater), with 2 
dots added. Add a dot In contact with the center cell on the right, 
and another in contact with the bottom cell on the left. Position 
this pattern about 1/3 of the way from the left edge of the tv screen 
and below the center of the screen vertically; this will forestall 
the disruption that occurs when the pattern hits the edges of the (iJO 
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x 42 decimal) grid area. 

Look especially Tor a small pattern of dots that wiggles along 
diagonally and "flys" to the edge of the screen. This is called a 
"glider" and is the simplest example of a traveling pattern. It is 
often interesting to follow the progress of parts of the debris of a 
developing pattern. For example, look for a pattern like a small 4 
that appears as part of the above 5 dot pattern, which in isolation 
has an interesting life of its own. 

To run Life, enter it into the computer and begin execution at 
F15E* Life is long, so disassemble it to check for key-in errors and 
save It on cassette if you have built the interface. While running, a 
slightly flickering "cursor" dot will appear in the center of the 
screen. It can be moved around by pressing keys on the left 
controller. L2 moves it up, L4 moves it left, L6 moves it right and 
L8 moves it down. L5 causes the dot at the cursor location to change 
from live to dead or vice versa. LO causes the current pattern to be 
updated to the next generation. This will continue as long as LO is 
held down. Notice that TV sync is lost during generation updating. 
If any left key (except LO) is held down, the cursor is suppressed and 
you can see what is "under" it. The cursor itself is not a live cell 
and its position has no affect on forming new generations. To clear 
the screen when it is cluttered, press "game reset" and run the 
program again. 

We programmed Life Just the way any user might. First we decided 
how the game should look and what compromises we would accept to make 
it easy to program the first version. Then we Identified the major 
components and flow of the program, including sections that should be 
subroutines. This is often done with boxes and arrows, arranged in 
diagrams call flowcharts. Next we wrote out the program in text lines 
that would each be implementable as a few 6502 instructions. Names 
were used for storage locations. We examined the text for logical 
flaws and disagreements with our overall plan. Then we assigned 
addresses for the named storage locations. Next we wrote the right 
side of the listing, still using names for many storage locations, and 
label names for locations that were the targets of long or frequent 
Jumps and branches. We then assigned F100 as the address of the first 
location of the program and counted bytes carefully through the code, 
assigning addresses to labeled instructions. Next we looked up the 
opcodes and wrote the left side of the listing (the actual Hex), 
filling in addresses at the same time. Finally, the long relative 
branohes were calculated (using the Relc key) and written on the hex 
listing as It was being keyed in. 

We disassembled (Ins Dump) to check for errors and saved the 
program on cassette. It ran the first time! Often even a short 
program will not work at first, but care in planning, especially with 
the early text version, will yield working programs much more often 
than the "hacker" approach favored by some programmers. If the 
program had been much longer, we would have tested It In parts. For 
example, the key Input section can be run without the generation 
update code. In professional programming publications, techniques to 
produce correct programs quickly have received much attention recently 
under the name "structured programming". 

Even If you enjoy this program, you will probably notice a number 
of things that you might want to Improve, which we Ignored In the 
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interest of a short and simple program. Examples includes 
maintaining sync (if not the picture) during generation updating, 
handling of the edges of the grid to really use those cells (perhaps 
with wrap around), counting the number of generations, plotting and 
moving whole patterns Instead of single dots, and better controller 
capability (diagonal motion, Joysticks). If you are really 
enthusiastic about Life, you may be interested in our "Lifecard" 
module which will soon be available. It features a 96 x 80 (decimal) 
game grid and display, all the Improvements mentioned above and more. 


Memory Usages (also P300 - F3D1 is used as a copy of the 
display) 

name location use 

MZ BO Mask of bit for (H0,V-) position, 

also for cursor position. 

AZ B1 Address offset for (H0,V-) position, 

also for cursor position. 

M* B2 Mask of bit for (H+,V-) position, 

also temporary storage. 

A* B3 Address offset for <H«-,V-) position. 

CZ B*J =0 if vortical middle cell at center is empty, 

else sFF. 

C-* B5 =0 if vertical middle cell at right is empty, 
else =FF. 

N- B6 Number or neighbors in left 3 cells. 

NZ B7 Number of neighbors in center 3 cells, 

including target cell. 

N+ B8 Number of neighbors in right 3 cells. 

HC B9 Horizontal cursor position (00 - 27). 

VC B9 Vertical cursor position (00 - 29). 

DOT BB Value of dot at cursor position (on s FF, off = 00). 


Note the to mark places where the Relc key was used to 
calculate relative branches. 


F100 A9 00 C0PCL: LDA I 00 ;Copy and clear subroutine 

85 8C STA Z 8C ;set address 

A9 F7 LDA I F7 

85 80 STA Z 8D ;for STPM 

A0 D2 LDY I D2 

F10A B9 FFEF Lis LDA Y EFFF 

88 DEY {Copy display to 

20 F7FF JSR STPH: ;4th page of memory 

Fill DO F7 BNE LI: 

A9 F*l LDA I F4 ;Reset STPM address 

85 8D STA Z 8D ;to display. 

A9 00 LDA I 00 

A0 D2 LDY I D2 

FI IB 88 L2: DEY 

20 F7FF JSR STPM: ;Clear display. 

DO FA BNE L2: 

60 RTS 

F122 A5 B2 NXH: LDA Z M+: 

85 B0 STA Z MZ: 


;Set up Tor next point, 
;MZ = Mt- 
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A5 B3 


LDA Z 

A*: 



85 B1 


STA Z 

AZ: 

;AZ s A* 


A5 B7 


LDA Z 

NZ: 



85 B6 


STA Z 

N-: 

;N- * NZ 


A5 B8 


LDA Z 

N+: 


F130 

85 B7 


STA Z 

NZ: 

;NZ * N+ 


A5 B5 


LDA Z 

C+t 



85 B4 


STA Z 

CZ: 

;CZ * O 


20 BEFF 


JSR 

CALP: 

;Gct V-,H* position, 


85 B2 


STA Z 

M+: 

;we will use "secret 


84 B3 


STY Z 

A+: 

;knowledge": successive bytes 


A2 00 


LDX I 

00 

;plot vertically down display. 


86 B5 


STX Z 

C+: 

;C* = 0 

F141 

39 OOF3 


AND Y 

F300 

;Test H+,V- position 


FO 01 


BEQ 

01 

;and count it. 


E8 


INX 




A 5 B2 


LDA Z 

H*: 



39 01F3 


AND Y 

F301 

;Test H*,VZ position 


FO 03 


BEQ 

03 

;and count it 


C6 B5 


DEC Z 

Cf: 

;for both C* (-1) 

P150 

E8 


INX 


;and N+. 


A5 B2 


LDA Z 

M*: 



39 02F3 


AND Y 

F302 

{Test H+,V+ position 


FO 01 


BEQ 

01 

;and count it. 


E8 


INX 




86 B8 


STX Z 

N+: 

;N* s of right neighbors. 


E6 8E 


INC Z 

8E 

;H* s H* + 1 


60 


RTS 



P15E 

20 OOF 1 

ENTRY: 

JSR 

COPCL: 

{Clear screen. 


A9 14 


LDA I 

14 



85 B9 


STA Z 

HC: 

;Set horiz and vertical 


85 BA 


STA Z 

VC: 

;cursor position. 

F167 

A5 B9 

KEEP: 

LDA Z 

HC: 



85 8E 


STA Z 

8E 



A5 BA 


LDA Z 

VC: 



85 8F 


STA Z 

8F 



20 BEFF 


JSR 

CALP: 

;Calculate cursor position 

P172 

85 BO 


STA Z 

MZ: 

;and save. 


84 B1 


STY Z 

AZ: 



A2 00 


LDX 1 

00 



39 OOFO 


AND Y 

FOOO 

;Test cursor position. 


FO 01 


BEQ 

01 

;00 => dot off. 


CA 


DEX 


;FF => dot on. 


86 BB 


STX Z 

DOT: 

;Save cursor block status. 

FI 80 

20 6FFA 

KREAD: 

JSR 

DSPL: 

{Display and read keys. 


A4 B1 


LDY Z 

AZ: 



A5 BO 


LDA Z 

HZ: 



59 OOFO 


EOR Y 

FOOO 

{Complement dot at 


20 F7FF 


JSR 

ST PM: 

{cursor position. 


A5 8A 


LDA Z 

8A 

;If no left key down, 


30 EF 


BMI 

KREAD: 

{loop on display. 

F191 

A5 BO 


LDA Z 

MZ: 



49 FF 


EOR I 

FF 



39 OOFO 


AND Y 

FOOO 



85 B2 


STA Z 

M+: 

{Save with bit masked off. 


A5 BO 


LDA Z 

MZ: 



25 BB 


AND Z 

DOT: 

{Re-establish original 


05 B2 


ORA Z 

M+: 

;dot value at cursor 

F1A0 

20 F7FF 


JSR 

STPM: 

{position. 
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A5 82 

LDA 

Z 

82 



C9 05 

CMP 

I 

05 



DO 09 

BNE 


09 



A9 FF 

LDA 

I 

FF 

;Complement final 


115 BB 

BOR 

Z 

DOT: 

{value of dot at 


85 BB 

STA 

z 

DOT: 

jcursor position. 


llC 80F1 

JMP 


KREAD: 


F1B2 

C9 02 

CMP 

I 

02 



DO 08 

BNE 


08 



A5 BA 

LDA 

z 

VC: 



FO AD < 

BEQ 


KEEP: 



C6 BA 

DEC 

z 

VC: 

{Move cursor up. 


10 A9 < 

BPL 


KEEP: 

Unconditional branch. 


C9 0*1 

CNF 

I 

OH 


F1C0 

DO 08 

BNE 


08 



A5 B9 

LDA 

z 

HC: 



FO A1 < 

BEQ 


KEEP: 



C6 B9 

DEC 

z 

HC: 

{Move cursor left 


10 9D < 

BPL 


KEEP: 

{Unconditional branch. 


C9 06 

CMP 

I 

06 



DO OA 

BNE 


OA 



A5 B9 

LDA 

z 

HC: 


FIDO 

C9 27 

CMP 

I 

27 



10 93 < 

3FL 


KEEP: 


FIDli 

E6 B9 

INC 

z 

HC: 

{Move cursor right. 


10 8F < 

BPL 


KEEP: 

{Unconditional branch. 


C9 08 

CMP 

I 

08 



DO 08 

BNE 


08 



A5 BA 

LDA 

z 

VC: 



C9 29 

CMP 

I 

29 


F1EO 

10 85 < 

BPL 


KEEP: 



E6 BA 

INC 

z 

VC: 

{Move cursor down. 


A5 8A 

LDA 

z 

8A 

{If left zero not down, 


DO 111 < 

BNE 


LINK: 

•bypass generation update. 


20 OOF 1 

J8R 


COPCL: 

{Save display and clear. 


85 8F 

STA 

z 

8F 

{Zero V-. 

PIED 

A9 00 NEXTV: 

LDA 

I 

00 



85 8E 

STA 

z 

BE 

{Zero H*. 

F1P1 

20 22F1 

jSR 


NXH: 

{Initialize for sweep 


20 22F1 

JSR 


NXH: 

{of a line of dots. 

F1F7 

20 22F1 NEXT1I: 

JSR 


NXH: 

{Update for next dot. 


8A 

TXA 



{Get N+. 


18 

CLC 





65 B7 

ADC 

z 

NZ: 

{Calculate number 


65 B6 

ADC 

z 

N-: 

;of neighbors. 

F200 

65 Bit 

ADC 

z 

CZ: 

;N* ♦ N- ♦ NZ - CZ 


C9 02 

CMP 

I 

02 



30 15 

BMI 


NEXT: 

{Skip if < 2. 


C9 03 

CMP 

I 

03 



FO 06 

BEQ 


06 

{Plot if = 3. 


10 OF 

BPL 


NEXT: 

{Skip if > 3. 


A5 BU 

LDA 

z 

CZ: 

{Must be s 2, 


FO OB 

BEQ 


NEXT: 

{skip if not occupied. 

F210 

A5 BO 

LDA 

z 

MZ: 

{Plot a 


All B1 

LDY 

z 

AZ: 

{dot at 


C8 

INY 



{the current position. 


19 OOFO 

ORA 

Y 

FOOO 



20 F7FF 

JSR 


STPM: 


F21B 

A5 8E < NEXT: 

LDA 

z 

8E 

{Loop if «♦ < 28. 
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P221 


F229 

F22C 


C9 28 

CMP I 

20 


30 D6 < 

BMI 

NEXTH: 


E6 8F 

INC Z 

8F 

5 V- s V- ♦ 1. 

A5 SF 

LDA Z 

8F 

;Loop if V- < 28. 

C9 28 

CMP I 

20 


30 C4 < 

BMI 

NEXTVt 


HC 67F1 LINK: 

JMP 

KEEP: 

{Generation complete, 
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Constructing and Connecting a Cassette Interface 


Sections 6 and 7 of Chapter *1 describe the operations needed to 
write and read programs on cassette tape. In this appendix we give 
details on construction and connection for the cassette interface. A 
schematic of the interface and a list of parts will be round at the 
end of this appendix. 

Theory of Operation 

The interface circuit is simply a signal buffer. The diode in 
the monitor input section clips the negative going parts of the audio 
signal from the cassette player. The resistors provide Impedance 
matching and isolation. The I.C. sections are Schmitt triggers. A 
Schmitt trigger takes a slow rough rising or falling signal, typical 
of the cassette monitor output, and makes a clean abrupt logic 
transition. These transitions are read by the 6502 processor from the 
6532 (RIOT) I/O port A. 

The pulses are recorded with three different intervals. The 
shortest interval represents a "I" bit, the medium interval represents 
a "0" and any longer interval is a "fill" or separator signal. Each 
byte is recorded as 0 bits, least significant first, plus a 9th parity 
bit. Each group of 9 bits is seperated by a "fill" signal. The 
parity bit is set "on" if the proceeding 0 bits have an odd number of 
"1" bits. This way of calculating the value of the parity bit is 
called "even parity", because in each 9 bit group an even number of 
bits will always be "on". When the tape is read, the parity of each 
group is cheoked and the reading stops if any group falls to have even 
parity. 

The part of the circuit connected to the cassette recorder 
microphone input simply isolates the cassette recorder from the game. 
The resistors provide a properly attenuated and impedencc matched 
signal for the recorder. The Jumper which connects points (b) and (c) 
in the schematic is In the proper position for most cassette 
recorders. Most inexpensive cassette recorders play back a signal 
that is Inverted from the one that was recorded. If your recorder's 
output is not inverted, wire the Jumper between points (a) and (b) to 
provide the extra Inversion needed. 

What Kind of Cassette Recorder to Use 


Two inexpensive cassette recorders that work well with the 
interface are the General Electric model 3-5001A and the Panasonic 
model RQ-2765. The Panasonic costa about $40 at discount and features 
a tape position counter, which makes it easier to find a program if 
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several have been recorded on one side of a cassette tape. The GE at 
about half the price is bulkier and laoks the tape counter, but works 
satisfactorily. Both of these recorders work with the Jumper as shown 
in the schematic. Many portable cassette recorders have a battery 
eliminator, but these vary in design and may damage your game. Always 
use a battery powered cassette recorder, and operate it only on its 
batteries . 


Construction 


With only one I.C. and a few passive components, this circuit 
can be constructed by a variety of techniques. A small piece of 
circuit board with holes on 1/10 inch centers is a convenient base for 
the components. If you use a socket for the I.C., construction will 
be easier and the I.C. is much less likely to be damaged. The 
completed board can be placed in a small plastic box, with the switch 
mounted on a hole in the box. Be sure to provide some strain relief 
for the cables so that they won't be pulled loose by handling. 

The connection to the game Itself can be made In one of two wuy3. 
One way is to use male and female controller connectors to connect the 
left controller to the interface and then through to the left 
controller socket on the game console. The other way is to 3lmply cut 
Into the cable on one of your keyboard controllers and connect 
directly to the wires there. You will probably find it most 
convenient to cut into the cable Tairly near the connector to the game 
console. The box containing the Interface can be connected directly 
to the controller cable. A short connecting cable, perhaps with a 
multi-prong connector to allow it to be disconnected, will make a more 
convenient package. 

On the plugs connecting to the cassette recorder, the shaft is 
ground and the tip carries the signal. On the 1N91^ diode a band will 
be found near one end of its small glass body. The end opposite the 
band is to bo connected to the ground part of the circuit. The 15 Ohm 
resistor should be rated at a minimum of one Watt to handle the 
largest possible signals from the recorder. The switch is a DPST 
(double pole single throw) though a DPDT can be used, leaving the 
extra terminals on the switch unconnected. The switch is shown open 
(or off) in the schematic. This is the switch position that 
disconnects the Interface when It is not actually in use. 

Connecting to the Video Computer System 

The cassette interface is very easy to connect. Be sure to 
connect it with the game and cassetto recorder both turned off. If It 
is attached directly to one of the controller cables, make sure this 
is the left controller and is plugged into the left controller socket 
on the game console. If the interface has its own connectors, connect 
it to the left controller socket and he sure that the controller you 
plug Into the interface is on your left. Next plug in the two cables 
to the cassette recorder. Since the two plugs are identical, you will 
have to label the cables to avoid confusion. Before turning on the 
game, be sure the cassette Interface switch is off. Most problems 
with the keyboard controllers and cassette interface are due to 
misconnected cables or to the cassette interface switch being 
inadvertently left on. 



Construct!rip; and Connecting a Cassette Interface 


PAGE E-3 


I.C. 

Resistors 

Capacitors 

Diode 

Switch 

PI and P2 
Misc. 

Optional 


Parts Mat 


1- 7KLS1K Six Inverting Schmitt triggers, 

in a IK pin DIP 

(Widely available by mail order.) 


?- 100 Ohm 
I- K70 Ohm 
I- 10k Ohm 
I- 15 Ohm 1 Watt 


RS 271-1311 
RS 271-1317 
RS 271-1335 

Can use 2 27 Ohm 1/2 watt 
in parallel RS 271-006 


1- .01 microfarad 
1- 1.0 microfarad 


RS 272-131 
RS 272-IK 19 

Observe polarity of this capacitor. 


1- 1N91K switching diode RS 276-1122 

1- subolnl DPDT RS 275-6IK 

A variety of switches will work. 

2- plugs 1/8 inch miniature plugs RS 27K-287 


Plastic box, shielded cable 
(to cassette recorder), 

IK pin DIP I.C. socket 

(RS 276-1999 or PS 276-1993), 

solder, wire, etc. 


Hale and Female 9-pln controller 
plugs: DE9P and DE9S, 
available from: California Digital 
Box 3097B 

Torrance, California 90503 


Note: Part numbers labeled with "RS" are 
distributed by Radio Shaok. 




Cassette Interface 






Owner Information 


Your MaglCard has been thoroughly tested at the factory and 
should provide years of programming enjoyment. It Is guaranteed for 
90 days against defects in materials or workmanship. If you suspect 
your MaglCard is defective, however, you should write to us rirst 
describing the symptoms—most likely you are not using it properly and 
a few words of advice will get you up and running. We of course 
cannot be responsible for any damage due to improper use of the 
MaglCard. 

Repairs after the warranty period has expired will be made at 
cost. Again, don't send us your MagiCard before notifying us of the 
nature of the problem and getting our authorization to return it for 
repair. 

We will be happy to answer any questions about MaglCard operation 
or programming problems. Please include a self-addressed stamped 
envelope to facilitate a reply. And let us know about any 
particularly interesting programs you write and would like to share 
with other MagiCard users. We intend to distribute sample programs 
for a nominal fee. 

Finally, note that Atari and Video Computer System are trademarks 
of Atari, Inc. The MagiCard will also work In Sears TeleGaae, a 
trademark of Scars Roebuck, Inc. A patent is pending on the MaglCard 


design, 



